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

    string optional

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

  • 工作的最終狀態。

  • title

    字串

    列印的文件標題。

PrintJobSource

列印工作的來源。

列舉

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

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

"EXTENSION"
指定工作是透過 Chrome API 建立。

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

PrintJobStatus

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

列舉

"FAILED"
表示列印工作因某些錯誤而中斷。

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

"PRINTED"
表示列印工作是在未出現任何錯誤的情況下列印。

PrintSettings

屬性

  • 顏色

    ColorMode

    要求的顏色模式。

  • 份副本

    數字

    要求的副本數量。

  • Duplex

    DuplexMode

    要求的雙面模式。

  • mediaSize

    MediaSize

    要求的媒體大小。

方法

getPrintJobs()

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

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

參數

傳回

  • Promise<PrintJobInfo[]>

    Chrome 96 以上版本

    Promise 僅適用於 Manifest V3 及以上版本，其他平台需要使用回呼。

活動

onPrintJobFinished

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

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

參數