chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Opis

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

Uprawnienia

printerProvider

Dostępność

Chrome 44 lub nowsza

Typy

PrinterInfo

Właściwości

  • opis

    ciąg znaków opcjonalny

    Opis drukarki zrozumiały dla człowieka.

  • 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”
Oznacza, że operacja została ukończona.

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

„INVALID_TICKET”
Określa, że bilet do wydrukowania jest nieprawidłowy. Na przykład bilet jest niezgodny z niektórymi funkcjami lub rozszerzenie nie może obsługiwać wszystkich ustawień z biletu.

„INVALID_DATA”
Wskazuje, że dokument jest nieprawidłowy. Na przykład dane mogą być uszkodzone lub 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 tym: contentType.

  • printerId

    tekst

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

  • zgłoszenie

    obiekt

    Wydrukuj bilet w formacie CJT.

    Odwołanie do CJT jest oznaczone jako wycofane. Jest wycofana tylko w przypadku Google Cloud Print. Nie jest 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 możliwości 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 wysyła żądanie dotyczące 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 nowszy 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Zdarzenie wywoływane, gdy menedżer drukowania wysyła żądanie 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 zażąda drukowania.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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