chrome.printingMetrics

説明

chrome.printingMetrics API を使用して、印刷の使用状況に関するデータを取得します。

権限

printingMetrics

対象

Chrome 79 以降 ChromeOS のみ をご覧ください。 <ph type="x-smartling-placeholder"></ph> ポリシーが必要

ColorMode

列挙型

"BLACK_AND_WHITE"
モノクロ モードが使用されたことを示します。

"COLOR"
カラーモードが使用されたことを示します。

DuplexMode

列挙型

"ONE_SIDED"
片面印刷が使用されたことを示します。

&quot;TWO_SIDED_LONG_EDGE&quot;
両面印刷(長辺をめくる)を指定します。

&quot;TWO_SIDED_SHORT_EDGE&quot;
両面印刷(短辺で反転)が行われたことを示します。

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_status
    Chrome 85 以降

    プリンタのステータス。

  • 設定

    印刷ジョブの設定。

  • ソース

    印刷ジョブを開始したユーザーを示すソース。

  • sourceId

    文字列(省略可)

    ソースの ID。source が PRINT_PREVIEW または ANDROID_APP の場合は null。

  • ジョブの最終ステータス。

  • title

    文字列

    印刷されたドキュメントのタイトル。

PrintJobSource

印刷ジョブのソース。

列挙型

"PRINT_PREVIEW"
ユーザーが開始した印刷プレビュー ページからジョブが作成されたことを指定します。

"ANDROID_APP"
ジョブが Android アプリから作成されたことを示します。

"EXTENSION"
Chrome API を使用して拡張機能によって作成されたことを示します。

&quot;ISOLATED_WEB_APP&quot;
ジョブが API を介して分離されたウェブアプリによって作成されたことを示します。

PrintJobStatus

印刷ジョブの最終ステータスを指定します。

列挙型

"FAILED"
エラーにより印刷ジョブが中断されたことを示します。

"CANCELED"
ユーザーまたは API によって印刷ジョブがキャンセルされたことを示します。

"PRINTED"
印刷ジョブがエラーなしで印刷されたことを示します。

PrintSettings

プロパティ

  • リクエストされたカラーモード。

  • コピー

    数値

    リクエストされたコピーの数。

  • Duplex

    リクエストされた二重モード。

  • mediaSize

    リクエストされたメディアのサイズ。

メソッド

getPrintJobs()

<ph type="x-smartling-placeholder"></ph> 約束
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

完了した印刷ジョブのリストを返します。

パラメータ

  • callback

    関数(省略可)

    callback パラメータは次のようになります。

    (jobs: PrintJobInfo[]) => void

戻り値

  • Promise&lt;PrintJobInfo[]&gt;

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

イベント

onPrintJobFinished

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

印刷ジョブの完了時に発生するイベント。これには、終了ステータス(FAILED、CANCELED、PRINTED)が含まれます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。

    (jobInfo: PrintJobInfo) => void