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 Epoch 紀元時間結束的毫秒為單位)。

  • 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"
表示列印工作因發生錯誤而中斷。

"已取消"
指出列印工作已由使用者或透過 API 取消。

"PRINTED"
表示列印工作已順利列印且未出現任何錯誤。

PrintSettings

屬性

  • 顏色

    ColorMode

    要求的色彩模式。

  • 副本

    號碼

    要求的副本數量。

  • Duplex

    DuplexMode

    要求的雙面模式。

  • mediaSize

    MediaSize

    要求的媒體大小。

方法

getPrintJobs()

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

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

參數

傳回

  • Promise<PrintJobInfo[]>

    Chrome 96 以上版本

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

活動

onPrintJobFinished

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

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

參數