chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Mô tả

API chrome.printerProvider hiển thị các sự kiện mà trình quản lý in sử dụng để truy vấn các máy in do tiện ích kiểm soát, truy vấn các chức năng của máy in và gửi lệnh in đến các máy in này.

Quyền

printerProvider

Phạm vi cung cấp

Chrome 44 trở lên

Loại

PrinterInfo

Thuộc tính

  • mô tả

    chuỗi không bắt buộc

    Nội dung mô tả dễ đọc của máy in.

  • id

    chuỗi

    Mã nhận dạng duy nhất của máy in.

  • tên

    chuỗi

    Tên dễ đọc của máy in.

PrintError

Mã lỗi được trả về để phản hồi sự kiện onPrintRequested.

Enum

"OK"
Chỉ định rằng thao tác đã hoàn tất thành công.

"FAILED"
Chỉ định rằng đã xảy ra lỗi chung.

"INVALID_TICKET"
Chỉ định rằng vé in không hợp lệ. Ví dụ: vé không nhất quán với một số chức năng hoặc tiện ích không xử lý được tất cả các chế độ cài đặt trong vé.

"INVALID_DATA"
Chỉ định rằng tài liệu không hợp lệ. Ví dụ: dữ liệu có thể bị hỏng hoặc định dạng không tương thích với tiện ích.

PrintJob

Thuộc tính

  • contentType

    chuỗi

    Loại nội dung của tài liệu. Các định dạng được hỗ trợ là "application/pdf" và "image/pwg-raster".

  • tài liệu

    Blob

    Blob chứa dữ liệu tài liệu cần in. Định dạng phải khớp với contentType.

  • printerId

    chuỗi

    Mã nhận dạng của máy in sẽ xử lý lệnh in.

  • phiếu yêu cầu hỗ trợ

    đối tượng

    Vé in ở định dạng CJT.

    Tham chiếu CJT được đánh dấu là không dùng nữa. Tính năng này chỉ không được dùng nữa đối với Google Cloud Print, chứ không phải đối với tính năng in trên ChromeOS.

  • tiêu đề

    chuỗi

    Tiêu đề của lệnh in.

Sự kiện

onGetCapabilityRequested

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

Sự kiện được kích hoạt khi trình quản lý in yêu cầu các chức năng của máy in.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

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

    • printerId

      chuỗi

    • resultCallback

      hàm

      Tham số resultCallback có dạng như sau: 

      (capabilities: object) => void

onGetPrintersRequested

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

Sự kiện được kích hoạt khi trình quản lý in yêu cầu máy in do các tiện ích cung cấp.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (resultCallback: function) => void

    • resultCallback

      hàm

      Tham số resultCallback có dạng như sau: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 trở lên 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Sự kiện được kích hoạt khi trình quản lý in yêu cầu thông tin về một thiết bị USB có thể là máy in.

Lưu ý: Ứng dụng không nên dựa vào sự kiện này được kích hoạt nhiều lần trên mỗi thiết bị. Nếu được hỗ trợ, thiết bị thông minh đã kết nối sẽ được trả về trong sự kiện onGetPrintersRequested.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

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

    • thiết bị

      usb.Device

    • resultCallback

      hàm

      Tham số resultCallback có dạng như sau: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

Sự kiện được kích hoạt khi trình quản lý in yêu cầu in.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

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

    • printJob

      PrintJob

    • resultCallback

      hàm

      Tham số resultCallback có dạng như sau: 

      (result: PrintError) => void