chrome.printingMetrics

說明

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

權限

printingMetrics

可用性

Chrome 79 以上版本 僅適用於 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 以上版本

    印表機狀態。

  • 設定

    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()

Promise 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

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

參數

傳回

  • Promise<PrintJobInfo[]>

    Chrome 96 以上版本

    只有資訊清單 V3 以上版本支援 Promise，其他平台則需使用回呼。

事件

onPrintJobFinished

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

列印工作完成時觸發的事件。包括任何終止狀態：FAILED、CANCELED 和 PRINTED。

參數