chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

설명

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

권한

printerProvider

가용성

Chrome 44 이상

유형

PrinterInfo

속성

  • 설명

    문자열 선택사항

    프린터의 인간이 읽을 수 있는 설명입니다.

  • id

    문자열

    고유 프린터 ID입니다.

  • 이름

    문자열

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

PrintError

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

열거형

'OK'
작업이 성공적으로 완료되었음을 나타냅니다.

'FAILED'
일반적인 오류가 발생했음을 나타냅니다.

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

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

PrintJob

속성

  • contentType

    문자열

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

  • 문서

    blob

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

  • printerId

    문자열

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

  • 티켓

    객체

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

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

  • 제목

    문자열

    인쇄 작업 제목입니다.

이벤트

onGetCapabilityRequested

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

인쇄 관리자가 프린터 기능을 요청할 때 발생하는 이벤트입니다.

매개변수

  • callback

    함수

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

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

    • printerId

      문자열

    • resultCallback

      함수

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

      (capabilities: object) => void

      • capabilities

        객체

        CDD 형식의 기기 기능입니다.

onGetPrintersRequested

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

인쇄 관리자가 확장 프로그램에서 제공하는 프린터를 요청할 때 발생하는 이벤트입니다.

매개변수

  • callback

    함수

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

    (resultCallback: function) => void

    • resultCallback

      함수

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

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

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

인쇄 관리자가 프린터일 수 있는 USB 기기에 관한 정보를 요청할 때 발생하는 이벤트입니다.

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

매개변수

  • callback

    함수

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

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

    • 기기

      usb.Device

    • resultCallback

      함수

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

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

인쇄 관리자가 인쇄를 요청할 때 발생하는 이벤트입니다.

매개변수

  • callback

    함수

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

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

    • printJob

      PrintJob

    • resultCallback

      함수

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

      (result: PrintError) => void