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

속성

  • 높이

    숫자

    인쇄에 사용된 미디어의 높이 (마이크로미터)입니다.

  • vendorId

    문자열

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

  • 너비

    숫자

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

Printer

속성

  • 이름

    문자열

    표시되는 프린터 이름입니다.

  • source

    PrinterSource

    프린터의 소스입니다.

  • uri

    문자열

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

PrinterSource

프린터의 소스입니다.

열거형

"USER"
사용자가 프린터를 추가했음을 나타냅니다.

'POLICY'
프린터가 정책을 통해 추가되었음을 명시합니다.

PrintJobInfo

속성

  • completionTime

    숫자

    작업 완료 시간 (Unix 에포크 이후의 밀리초 단위)입니다.

  • creationTime

    숫자

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

  • id

    문자열

    작업의 ID입니다.

  • numberOfPages

    숫자

    문서의 페이지 수입니다.

  • 프린터

    프린터

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

  • printer_status

    PrinterStatus

    Chrome 85 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

    프린터의 상태입니다.

  • 설정

    PrintSettings

    인쇄 작업의 설정입니다.

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

  • sourceId

    문자열(선택사항)

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

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

  • 제목

    문자열

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

PrintJobSource

인쇄 작업의 소스입니다.

열거형

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

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

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

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

PrintJobStatus

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

열거형

"FAILED"
인쇄 작업이 오류로 인해 중단되었다고 지정합니다.

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

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

PrintSettings

속성

  • 색상

    ColorMode

    요청된 색상 모드입니다.

  • 사본

    숫자

    요청된 사본 수입니다.

  • 듀플렉스

    DuplexMode

    요청된 이중 모드입니다.

  • mediaSize

    MediaSize

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

메서드

getPrintJobs()

<ph type="x-smartling-placeholder"></ph> 프로미스 를 통해 개인정보처리방침을 정의할 수 있습니다.
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    (jobs: PrintJobInfo[]) => void

반환 값

  • Promise&lt;PrintJobInfo[]&gt;

    Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

이벤트

onPrintJobFinished

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

인쇄 작업이 완료되면 이벤트가 시작됩니다. 여기에는 종료 상태(FAILED, CANCELED, PRINTED)가 포함됩니다.

매개변수

  • 콜백

    함수

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

    (jobInfo: PrintJobInfo) => void