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