chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Opis

Interfejs API chrome.printerProvider udostępnia zdarzenia używane przez menedżera drukowania do wysyłania zapytań do drukarek kontrolowanych przez rozszerzenia, sprawdzania ich możliwości i przesyłania do nich zadań drukowania.

Uprawnienia

printerProvider

Dostępność

Chrome 44 lub nowsza wersja

Typy

PrinterInfo

Właściwości

  • opis

    ciąg znaków opcjonalny

    Zrozumiały dla człowieka opis drukarki.

  • id

    tekst

    Unikalny identyfikator drukarki.

  • nazwa

    tekst

    Zrozumiała dla człowieka nazwa drukarki.

PrintError

Kody błędów zwracane w odpowiedzi na zdarzenie onPrintRequested.

Typ wyliczeniowy

"OK"
Wskazuje, że operacja została zakończona pomyślnie.

"FAILED"
Wskazuje, że wystąpił ogólny błąd.

"INVALID_TICKET"
Określa, że bilet wydruku jest nieprawidłowy. Na przykład bilet jest niezgodny z niektórymi funkcjami lub rozszerzenie nie może obsłużyć wszystkich ustawień z biletu.

"INVALID_DATA"
Wskazuje, że dokument jest nieprawidłowy. Na przykład dane mogą być uszkodzone lub ich format może być niezgodny z rozszerzeniem.

PrintJob

Właściwości

  • contentType

    tekst

    Typ zawartości dokumentu. Obsługiwane formaty to "application/pdf" i "image/pwg-raster".

  • dokument

    Blob

    Obiekt blob zawierający dane dokumentu do wydrukowania. Format musi być zgodny z: contentType.

  • printerId

    tekst

    Identyfikator drukarki, która powinna obsłużyć zadanie.

  • zgłoszenie

    obiekt

    Wydrukuj bilet w formacie CJT.

    Odwołanie do CJT jest oznaczone jako wycofane. Została wycofana tylko w przypadku Google Cloud Print. Nie została wycofana w przypadku drukowania w ChromeOS.

  • tytuł

    tekst

    Tytuł zadania drukowania.

Wydarzenia

onGetCapabilityRequested

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

Zdarzenie wywoływane, gdy menedżer drukowania żąda informacji o możliwościach drukarki.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • printerId

      tekst

    • resultCallback

      funkcja

      Parametr resultCallback wygląda tak:

      (capabilities: object) => void

onGetPrintersRequested

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

Zdarzenie wywoływane, gdy menedżer drukowania żąda drukarek udostępnianych przez rozszerzenia.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (resultCallback: function) => void

    • resultCallback

      funkcja

      Parametr resultCallback wygląda tak:

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 lub nowsza wersja 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Zdarzenie wywoływane, gdy menedżer drukowania żąda informacji o urządzeniu USB, które może być drukarką.

Uwaga: aplikacja nie powinna polegać na tym, że to zdarzenie zostanie wywołane więcej niż raz na urządzenie. Jeśli połączone urządzenie jest obsługiwane, powinno zostać zwrócone w zdarzeniu onGetPrintersRequested.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

onPrintRequested

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

Zdarzenie wywoływane, gdy menedżer drukowania żąda drukowania.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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