説明
chrome.printingMetrics API を使用して、印刷の使用状況に関するデータを取得します。
権限
printingMetrics対象
型
ColorMode
列挙型
"BLACK_AND_WHITE"
モノクロ モードが使用されたことを示します。
"COLOR"
カラーモードが使用されたことを示します。
DuplexMode
列挙型
"ONE_SIDED"
片面印刷が使用されたことを示します。
"TWO_SIDED_LONG_EDGE"
両面印刷（長辺をめくる）を指定します。
"TWO_SIDED_SHORT_EDGE"
両面印刷（短辺で反転）が行われたことを示します。
MediaSize
プロパティ
-
height
数値
印刷に使用するメディアの高さ（マイクロメートル）。
-
vendorId
文字列
ベンダー指定の ID。例:「iso_a3_297x420mm」または「na_index-3x5_3x5in」と指定します。指定可能な値は「media」です。IPP 属性。詳しくは IANA のページをご覧ください。
-
幅
数値
印刷に使用するメディアの幅（マイクロメートル）。
Printer
プロパティ
-
name
文字列
プリンタの表示名。
-
ソース
プリンタのソース。
-
uri
文字列
プリンタのフルパス。プロトコル、ホスト名、ポート、キューが含まれます。
PrinterSource
プリンタのソース。
列挙型
"USER"
ユーザーがプリンタを追加したことを指定します。
"POLICY"
プリンタがポリシーによって追加されたことを指定します。
PrintJobInfo
プロパティ
-
completionTime
数値
ジョブの完了時間（Unix エポックからのミリ秒単位の経過時間）。
-
creationTime
数値
ジョブの作成時間（Unix エポックからのミリ秒単位の経過時間）。
-
id
文字列
ジョブの ID。
-
numberOfPages
数値
ドキュメントのページ数。
-
プリンタ
ドキュメントを印刷したプリンタに関する情報。
-
printer_statusChrome 85 以降
プリンタのステータス。
-
印刷ジョブの設定。
-
ソース
印刷ジョブを開始したユーザーを示すソース。
-
sourceId
文字列（省略可）
ソースの ID。source が PRINT_PREVIEW または ANDROID_APP の場合は null。
-
status
ジョブの最終ステータス。
-
title
文字列
印刷されたドキュメントのタイトル。
PrintJobSource
印刷ジョブのソース。
列挙型
"PRINT_PREVIEW"
ユーザーが開始した印刷プレビュー ページからジョブが作成されたことを指定します。
"ANDROID_APP"
ジョブが Android アプリから作成されたことを示します。
"EXTENSION"
Chrome API を使用して拡張機能によって作成されたことを示します。
"ISOLATED_WEB_APP"
ジョブが API を介して分離されたウェブアプリによって作成されたことを示します。
PrintJobStatus
印刷ジョブの最終ステータスを指定します。
列挙型
"FAILED"
エラーにより印刷ジョブが中断されたことを示します。
"CANCELED"
ユーザーまたは API によって印刷ジョブがキャンセルされたことを示します。
"PRINTED"
印刷ジョブがエラーなしで印刷されたことを示します。
PrintSettings
プロパティ
-
リクエストされたカラーモード。
-
コピー
数値
リクエストされたコピーの数。
-
Duplex
リクエストされた二重モード。
-
mediaSize
リクエストされたメディアのサイズ。
メソッド
getPrintJobs()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
完了した印刷ジョブのリストを返します。
パラメータ
-
callback
関数（省略可）
callbackパラメータは次のようになります。(jobs: PrintJobInfo[]) => void
-
ジョブ
-
戻り値
-
Promise<PrintJobInfo[]>
Chrome 96 以降Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。
イベント
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
印刷ジョブの完了時に発生するイベント。これには、終了ステータス（FAILED、CANCELED、PRINTED）が含まれます。
パラメータ
-
callback
関数
callbackパラメータは次のようになります。(jobInfo: PrintJobInfo) => void
-
jobInfo
-