browser.printingMetrics

說明

使用 chrome.printingMetrics API 擷取列印用量資料。

權限

printingMetrics

可用性

Chrome 79 以上版本 Chrome 148 以上版本的瀏覽器* 僅適用於 ChromeOS 需要政策

類型

ColorMode

列舉

"BLACK_AND_WHITE"
指定使用黑白模式。

"COLOR"
指定使用色彩模式。

DuplexMode

列舉

"ONE_SIDED"
指定使用單面列印。

"TWO_SIDED_LONG_EDGE"
指定使用雙面列印，沿長邊翻頁。

"TWO_SIDED_SHORT_EDGE"
指定使用雙面列印，短邊翻頁。

MediaSize

屬性

  • 高度

    數字

    列印媒體的高度 (以微米為單位)。

  • vendorId

    字串

    供應商提供的 ID，例如「iso_a3_297x420mm」或「na_index-3x5_3x5in」。可能的值為「media」IPP 屬性的值，請參閱 IANA 頁面。

  • 寬度

    數字

    列印媒體的寬度 (以微米為單位)。

Printer

屬性

  • 名稱

    字串

    印表機的顯示名稱。

  • 來源

    PrinterSource

    印表機的來源。

  • uri

    字串

    印表機的完整路徑。包含通訊協定、主機名稱、通訊埠和佇列。

PrinterSource

印表機的來源。

列舉

"USER"
指定印表機是由使用者新增。

「POLICY」
指定透過政策新增的印表機。

PrintJobInfo

屬性

  • completionTime

    數字

    工作完成時間 (自 Unix 紀元起算，以毫秒為單位)。

  • creationTime

    數字

    工作建立時間 (自 Unix 紀元起算，以毫秒為單位)。

  • id

    字串

    工作的 ID。

  • numberOfPages

    數字

    文件頁數。

  • 印表機

    印表機

    列印文件的印表機資訊。

  • printer_status

    PrinterStatus

    Chrome 85 以上版本 Chrome 148 以上版本為 browser.*

    印表機的狀態。

  • 設定

    PrintSettings

    列印工作的設定。

  • 顯示發起列印工作的來源。

  • sourceId

    字串 選填

    來源 ID。如果來源是 PRINT_PREVIEW 或 ANDROID_APP，則為空值。

  • 工作的最終狀態。

  • title

    字串

    已列印文件的標題。

PrintJobSource

列印工作的來源。

列舉

"PRINT_PREVIEW"
指定工作是由使用者啟動的「預覽列印」頁面建立。

"ANDROID_APP"
指定工作是由 Android 應用程式建立。

「EXTENSION」
指定工作是由擴充功能透過 Chrome API 建立。

"ISOLATED_WEB_APP"
指定工作是由隔離網頁應用程式透過 API 建立。

PrintJobStatus

指定列印工作的最終狀態。

列舉

"FAILED"
指定列印工作因發生錯誤而中斷。

「CANCELED」
表示列印工作已由使用者或透過 API 取消。

"PRINTED"
指定列印工作已列印，未發生任何錯誤。

PrintSettings

屬性

  • 顏色

    ColorMode

    要求的色彩模式。

  • 份

    數字

    要求的副本數量。

  • Duplex

    DuplexMode

    要求的雙工模式。

  • mediaSize

    MediaSize

    要求媒體的大小。

方法

getPrintJobs()

browser.printingMetrics.getPrintJobs(): Promise<PrintJobInfo[]>

傳回已完成的列印工作清單。

傳回

  • Promise<PrintJobInfo[]>

    Chrome 96 以上版本 Chrome 148 以上版本中的 browser.*

事件

onPrintJobFinished

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

列印工作完成時觸發的事件。包括下列任何終止狀態：失敗、已取消和已列印。

參數