chrome.printerProvider

Opis

Interfejs API chrome.printerProvider udostępnia zdarzenia używane przez menedżera wydruku do wysyłania zapytań o drukarki kontrolowane przez rozszerzenia, wysyłanie zapytań o ich możliwości i przesyłanie zadań drukowania do tych drukarek.

Uprawnienia

printerProvider

Dostępność

Chrome w wersji 44 lub nowszej .

Typy

PrinterInfo

Właściwości

  • opis

    ciąg znaków opcjonalny

    Zrozumiały dla człowieka opis drukarki.

  • id

    ciąg znaków

    Unikalny identyfikator drukarki.

  • nazwa

    ciąg znaków

    Zrozumiała dla człowieka nazwa drukarki.

PrintError

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

Typ wyliczeniowy

"OK"
Określa, że operacja została ukończona.

"FAILED"
Określa, że wystąpił ogólny błąd.

"INVALID_TICKET"
Określa, że bilet druku jest nieprawidłowy. Na przykład zgłoszenie jest niezgodne z niektórymi możliwościami lub rozszerzenie nie jest w stanie obsłużyć wszystkich ustawień zgłoszenia.

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

PrintJob

Właściwości

  • contentType

    ciąg znaków

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

  • dokument

    Blob

    Obiekt blob zawierający dane dokumentu do wydrukowania. Format musi pasować do: contentType.

  • printerId

    ciąg znaków

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

  • zgłoszenie

    Obiekt

    Wydrukuj zgłoszenie w formacie CJT.

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

  • tytuł

    ciąg znaków

    Tytuł zadania drukowania.

Wydarzenia

onGetCapabilityRequested

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

Zdarzenie jest wywoływane, gdy menedżer wydruku wysyła żądanie dotyczące funkcji drukarki.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • printerId

      ciąg znaków

    • resultCallback

      funkcja

      Parametr resultCallback wygląda tak: 

      (capabilities: object) => void

onGetPrintersRequested

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

Zdarzenie jest wywoływane, gdy menedżer wydruku wysyła żądanie drukarek udostępnionych przez rozszerzenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (resultCallback: function) => void

    • resultCallback

      funkcja

      Parametr resultCallback wygląda tak: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome w wersji 45 lub nowszej .
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Zdarzenie jest wywoływane, gdy menedżer wydruku prosi o informacje o urządzeniu USB, które może być drukarką.

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • urządzenie

      usb.Device

    • resultCallback

      funkcja

      Parametr resultCallback wygląda tak: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

Zdarzenie jest wywoływane, gdy menedżer wydruku poprosi o wydrukowanie.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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