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

    string

    공급업체가 제공한 ID입니다(예: 'iso_a3_297x420mm' 또는 'na_index-3x5_3x5in'). 가능한 값은 'media' IPP 속성 값이며 IANA 페이지에서 확인할 수 있습니다 .

  • 너비

    숫자

    인쇄에 사용되는 미디어의 너비 (마이크로미터)입니다.

Printer

속성

  • 이름

    string

    표시된 프린터 이름입니다.

  • 소스

    PrinterSource

    프린터 소스입니다.

  • uri

    string

    프린터의 전체 경로입니다. 프로토콜, 호스트 이름, 포트, 큐를 포함합니다.

PrinterSource

프린터 소스입니다.

열거형

"USER"
사용자가 프린터를 추가했음을 지정합니다.

"POLICY"
프린터가 정책을 통해 추가되었음을 지정합니다.

PrintJobInfo

속성

  • completionTime

    숫자

    작업 완료 시간 (유닉스 시간 이후의 밀리초 단위)입니다.

  • creationTime

    숫자

    작업 생성 시간 (유닉스 에포크 이후의 밀리초 단위)입니다.

  • id

    string

    작업의 ID입니다.

  • numberOfPages

    숫자

    문서의 페이지 수입니다.

  • 프린터

    프린터

    문서를 인쇄한 프린터에 관한 정보입니다.

  • printer_status

    PrinterStatus

    Chrome 85 이상

    프린터의 상태입니다.

  • 설정

    PrintSettings

    인쇄 작업의 설정입니다.

  • 인쇄 작업을 시작한 사용자를 보여주는 소스입니다.

  • sourceId

    문자열 선택사항

    소스의 ID입니다. 소스가 PRINT_PREVIEW 또는 ANDROID_APP인 경우 null입니다.

  • 작업의 최종 상태입니다.

  • title

    string

    인쇄된 문서의 제목입니다.

PrintJobSource

인쇄 작업의 소스입니다.

열거형

"PRINT_PREVIEW"
사용자가 시작한 인쇄 미리보기 페이지에서 작업이 생성되었음을 지정합니다.

"ANDROID_APP"
작업이 Android 앱에서 생성되었음을 지정합니다.

"EXTENSION"
작업이 Chrome API를 통해 확장 프로그램에서 생성되었음을 지정합니다.

"ISOLATED_WEB_APP"
작업이 API를 통해 격리된 웹 앱에서 생성되었음을 지정합니다.

PrintJobStatus

인쇄 작업의 최종 상태를 지정합니다.

열거형

"FAILED"
일부 오류로 인해 인쇄 작업이 중단되었음을 나타냅니다.

"CANCELED"
인쇄 작업이 사용자 또는 API를 통해 취소되었음을 지정합니다.

"PRINTED"
인쇄 작업이 오류 없이 인쇄되었음을 지정합니다.

PrintSettings

속성

  • 색상

    ColorMode

    요청된 색상 모드입니다.

  • 사본

    숫자

    요청된 사본 수입니다.

  • 듀플렉스

    DuplexMode

    요청된 이중 모드입니다.

  • mediaSize

    MediaSize

    요청된 미디어 크기입니다.

방법

getPrintJobs()

프로미스 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

완료된 인쇄 작업의 목록을 반환합니다.

매개변수

  • 콜백

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (jobs: PrintJobInfo[])=>void

반환 값

  • Promise<PrintJobInfo[]>

    Chrome 96 이상

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

이벤트

onPrintJobFinished

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

인쇄 작업이 완료되면 이벤트가 시작됩니다. 여기에는 FAILED, CANCELED, PRINTED와 같은 해지 상태가 포함됩니다.

매개변수