chrome.printerProvider

설명

chrome.printerProvider API는 확장 프로그램에서 제어하는 프린터를 쿼리하고 기능을 쿼리하며 이러한 프린터에 인쇄 작업을 제출하기 위해 인쇄 관리자가 사용하는 이벤트를 노출합니다.

권한

printerProvider

지원 대상

Chrome 44 이상

유형

PrinterInfo

속성

  • 설명

    문자열 선택사항

    사람이 읽을 수 있는 프린터 설명입니다.

  • id

    string

    고유한 프린터 ID입니다.

  • 이름

    string

    사람이 읽을 수 있는 프린터의 이름입니다.

PrintError

onPrintRequested 이벤트에 대한 응답으로 반환된 오류 코드입니다.

열거형

"OK"
작업이 성공적으로 완료되었음을 지정합니다.

"FAILED"
일반적인 오류가 발생했음을 지정합니다.

"INVALID_TICKET"
인쇄 티켓이 유효하지 않음을 지정합니다. 예를 들어 티켓이 일부 기능과 일치하지 않거나 확장 프로그램이 티켓의 모든 설정을 처리할 수 없습니다.

"INVALID_DATA"
문서가 유효하지 않음을 지정합니다. 예를 들어 데이터가 손상되었거나 형식이 확장 프로그램과 호환되지 않을 수 있습니다.

PrintJob

속성

  • contentType

    string

    문서 콘텐츠 유형입니다. 지원되는 형식은 "application/pdf" 및 "image/pwg-raster"입니다.

  • 문서

    Blob

    인쇄할 문서 데이터가 포함된 Blob입니다. 형식은 contentType과(와) 일치해야 합니다.

  • printerId

    string

    작업을 처리해야 하는 프린터의 ID입니다.

  • 티켓

    객체

    CJT 형식으로 티켓을 인쇄합니다.

    CJT 참조는 지원 중단된 것으로 표시됩니다. 이 기능은 Google 클라우드 프린트에서만 지원 중단됩니다. ChromeOS 인쇄에서도 지원 중단되지 않습니다.

  • title

    string

    인쇄 작업 제목입니다.

이벤트

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

인쇄 관리자가 프린터 기능을 요청하면 이벤트가 실행됩니다.

매개변수

  • 콜백

    기능

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

    (printerId: string,resultCallback: function)=>void

    • printerId

      string

    • resultCallback

      기능

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

      (capabilities: object)=>void

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

인쇄 관리자가 확장 프로그램에서 제공한 프린터를 요청하면 이벤트가 실행됩니다.

매개변수

  • 콜백

    기능

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

    (resultCallback: function)=>void

    • resultCallback

      기능

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

      (printerInfo: PrinterInfo[])=>void

onGetUsbPrinterInfoRequested

Chrome 45 이상 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

인쇄 관리자가 프린터일 수 있는 USB 기기에 대한 정보를 요청하면 이벤트가 실행됩니다.

참고: 애플리케이션은 기기당 두 번 이상 실행되는 이 이벤트에 의존해서는 안 됩니다. 연결된 기기가 지원되는 경우 onGetPrintersRequested 이벤트에서 반환되어야 합니다.

매개변수

  • 콜백

    기능

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

    (device: usb.Device,resultCallback: function)=>void

    • 기기

      usb.Device

    • resultCallback

      기능

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

      (printerInfo?: PrinterInfo)=>void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

인쇄 관리자가 인쇄를 요청하면 이벤트가 실행됩니다.

매개변수

  • 콜백

    기능

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

    (printJob: PrintJob,resultCallback: function)=>void

    • printJob

      PrintJob

    • resultCallback

      기능

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

      (result: PrintError)=>void