Extensions
Welcome What's new in Chrome extensions Getting started
Welcome to Manifest V3 Extensions platform vision Overview of Manifest V3 Migrating to Manifest V3 Manifest V3 migration checklist Manifest V2 support timeline
What are extensions? What are themes? Frequently asked questions Extensions quality guidelines FAQ
API Reference Samples
Extension development overview Manifest file format Architecture overview Declare permissions Design the user interface Debugging extensions Samples
Message passing Content scripts Manage events with service workers Match patterns Using promises Cross-origin isolation
Cross-origin XMLHttpRequest Using eval in Chrome extensions
Overriding Chrome settings Extending DevTools OAuth2: Authenticate users with Google Overriding Chrome pages Rich notifications API
Migrating from background pages to service workers
Protect user privacy Declare permissions and warn users Stay secure Accessibility (a11y) Localization message formats Give users options
Extension hosting Alternative extension installation methods Installing extensions on Linux Tutorial: Google analytics
About Manifest V2 Getting started
What are extensions? What are themes? Frequently asked questions
Extension development overview Manifest file format Architecture overview Declare permissions Design the user interface Debugging extensions Samples
Message passing Content scripts Manage events with background scripts Match patterns Cross-origin isolation
Cross-origin XMLHttpRequest Using eval in Chrome extensions
Overriding Chrome settings Extending DevTools OAuth2: Authenticate users with Google Overriding Chrome pages Rich notifications API
Migrate to event-driven background scripts
Protect user privacy Declare permissions and warn users Stay secure Accessibility (a11y) Localization message formats Give users options
Chrome Web Store Alternative extension distribution options Installing extensions on Linux Tutorial: Google analytics

chrome.printingMetrics

  • Description

    Use the chrome.printingMetrics API to fetch data about printing usage.

  • Permissions
    printingMetrics
  • Availability
    Chrome 79+

Summary

Types

ColorMode

Type

"BLACK_AND_WHITE"

, or

"COLOR"

DuplexMode

Type

"ONE_SIDED"

,

"TWO_SIDED_LONG_EDGE"

, or

"TWO_SIDED_SHORT_EDGE"

MediaSize

Properties

  • height

    number

    Height (in micrometers) of the media used for printing.

  • vendorId

    string

    Vendor-provided ID, e.g. "iso_a3_297x420mm" or "na_index-3x5_3x5in". Possible values are values of "media" IPP attribute and can be found on IANA page .

  • width

    number

    Width (in micrometers) of the media used for printing.

Printer

Properties

  • name

    string

    Displayed name of the printer.

  • The source of the printer.

  • uri

    string

    The full path for the printer. Contains protocol, hostname, port, and queue.

PrinterSource

The source of the printer.

Type

"USER"

, or

"POLICY"

PrintJobInfo

Properties

  • completionTime

    number

    The job completion time (in milliseconds past the Unix epoch).

  • creationTime

    number

    The job creation time (in milliseconds past the Unix epoch).

  • id

    string

    The ID of the job.

  • numberOfPages

    number

    The number of pages in the document.

  • printer

    Printer

    The info about the printer which printed the document.

  • printer_status

    PrinterStatus

    Chrome 85+

    The status of the printer.

  • The settings of the print job.

  • Source showing who initiated the print job.

  • sourceId

    string optional

    ID of source. Null if source is PRINT_PREVIEW or ANDROID_APP.

  • The final status of the job.

  • title

    string

    The title of the document which was printed.

PrintJobSource

The source of the print job.

Type

"PRINT_PREVIEW"

,

"ANDROID_APP"

, or

"EXTENSION"

PrintJobStatus

The final status of the print job.

Type

"FAILED"

,

"CANCELED"

, or

"PRINTED"

PrintSettings

Properties

  • The requested color mode.

  • copies

    number

    The requested number of copies.

  • The requested duplex mode.

  • mediaSize

    MediaSize

    The requested media size.

Methods

getPrintJobs

chrome.printingMetrics.getPrintJobs(
  callback?: function,
)
Promise

Returns the list of the finished print jobs.

Parameters

Returns

  • Promise<PrintJobInfo[]>

    Pending

    This only returns a Promise when the callback parameter is not specified, and with MV3+. The type inside the Promise is the same as the 1st argument to callback.

Events

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

Event fired when the print job is finished. This includes any of termination statuses: FAILED, CANCELED and PRINTED.

Parameters