說明
使用 chrome.printingMetrics
API 擷取列印用量相關資料。
權限
printingMetrics
適用國家/地區
類型
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
屬性
-
名稱
字串
顯示印表機名稱。
-
印表機的來源。
-
uri
字串
印表機的完整路徑。包含通訊協定、主機名稱、通訊埠和佇列。
PrinterSource
印表機的來源。
列舉
"USER"
表示已有使用者新增印表機。
"POLICY"
指出透過政策新增印表機。
PrintJobInfo
屬性
-
completionTime
號碼
工作完成時間 (以 Unix 紀元以來的毫秒為單位)。
-
creationTime
號碼
工作建立時間 (從 Unix Epoch 紀元時間結束的毫秒為單位)。
-
id
字串
工作的 ID。
-
numberOfPages
號碼
文件的頁數。
-
印表機
列印文件的印表機相關資訊。
-
printer_statusChrome 85 以上版本
印表機的狀態。
-
列印工作的設定。
-
來源顯示啟動列印工作的使用者。
-
sourceId
字串 選用
來源的 ID。如果來源是 PRINT_PREVIEW 或 ANDROID_APP,則為空值。
-
status
工作的最終狀態。
-
title
字串
列印的文件標題。
PrintJobSource
列印工作的來源。
列舉
"PRINT_PREVIEW"
表示工作是透過使用者啟動的「列印預覽」頁面建立。
"ANDROID_APP"
表示工作是透過 Android 應用程式建立。
"EXTENSION"
表示擴充功能是透過 Chrome API 建立的工作。
"ISOLATED_WEB_APP"
指定工作是由 API 的隔離網頁應用程式建立。
PrintJobStatus
指定列印工作的最終狀態。
列舉
"FAILED"
表示列印工作因發生錯誤而中斷。
"已取消"
指出列印工作已由使用者或透過 API 取消。
"PRINTED"
表示列印工作已順利列印且未出現任何錯誤。
PrintSettings
屬性
-
顏色
要求的色彩模式。
-
副本
號碼
要求的副本數量。
-
Duplex
要求的雙面模式。
-
mediaSize
要求的媒體大小。
方法
getPrintJobs()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
傳回已完成的列印工作清單。
參數
-
回呼
函式選用
callback
參數如下所示:(jobs: PrintJobInfo[]) => void
-
工作
-
傳回
-
Promise<PrintJobInfo[]>
Chrome 96 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
活動
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
列印工作完成時會觸發事件。包括任何終止狀態:失敗、已取消和列印。
參數
-
回呼
功能
callback
參數如下所示:(jobInfo: PrintJobInfo) => void
-
jobInfo
-