chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

chrome.printerProvider API จะแสดงเหตุการณ์ที่ใช้โดยตัวจัดการการพิมพ์เพื่อค้นหาเครื่องพิมพ์ที่ส่วนขยายควบคุม เพื่อค้นหาความสามารถของเครื่องพิมพ์ และเพื่อส่งงานพิมพ์ไปยังเครื่องพิมพ์เหล่านี้

สิทธิ์

printerProvider

ความพร้อมใช้งาน

Chrome 44 ขึ้นไป

ประเภท

PrinterInfo

พร็อพเพอร์ตี้

  • คำอธิบาย

    สตริง ไม่บังคับ

    คำอธิบายที่มนุษย์อ่านได้ของเครื่องพิมพ์

  • id

    สตริง

    รหัสเครื่องพิมพ์ที่ไม่ซ้ำกัน

  • name

    สตริง

    ชื่อที่มนุษย์อ่านได้ของเครื่องพิมพ์

PrintError

รหัสข้อผิดพลาดที่ส่งคืนในการตอบกลับเหตุการณ์ onPrintRequested

ค่าแจกแจง

"ตกลง"
ระบุว่าการดำเนินการเสร็จสมบูรณ์แล้ว

"ล้มเหลว"
ระบุว่าเกิดข้อผิดพลาดทั่วไป

"INVALID_TICKET"
ระบุว่าตั๋วที่พิมพ์ไม่ถูกต้อง เช่น ตั๋วไม่สอดคล้องกับความสามารถบางอย่าง หรือส่วนขยายไม่สามารถจัดการการตั้งค่าทั้งหมดจากตั๋วได้

"INVALID_DATA"
ระบุว่าเอกสารไม่ถูกต้อง เช่น ข้อมูลอาจเสียหายหรือรูปแบบไม่รองรับส่วนขยาย

PrintJob

พร็อพเพอร์ตี้

  • contentType

    สตริง

    ประเภทเนื้อหาของเอกสาร รูปแบบที่รองรับคือ "application/pdf" และ "image/pwg-raster"

  • เอกสาร

    Blob

    Blob ที่มีข้อมูลเอกสารที่จะพิมพ์ รูปแบบต้องตรงกับ contentType

  • printerId

    สตริง

    รหัสของเครื่องพิมพ์ที่ควรจัดการงาน

  • คำขอแจ้งปัญหา

    ออบเจ็กต์

    พิมพ์ตั๋วในรูปแบบ CJT

    ระบบจะทำเครื่องหมายการอ้างอิง CJT ว่าเลิกใช้งานแล้ว ระบบเลิกใช้สำหรับ Google Cloud Print เท่านั้น แต่ไม่ได้เลิกใช้สำหรับการพิมพ์ใน ChromeOS

  • title

    สตริง

    ชื่องานพิมพ์

กิจกรรม

onGetCapabilityRequested

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

เหตุการณ์ที่ทริกเกอร์เมื่อตัวจัดการการพิมพ์ขอความสามารถของเครื่องพิมพ์

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

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

    • printerId

      สตริง

    • resultCallback

      ฟังก์ชัน

      พารามิเตอร์ resultCallback มีลักษณะดังนี้ 

      (capabilities: object) => void

      • ความสามารถ

        ออบเจ็กต์

        ความสามารถของอุปกรณ์ในรูปแบบ 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 ที่อาจเป็นเครื่องพิมพ์

หมายเหตุ: แอปพลิเคชันไม่ควรอาศัยเหตุการณ์นี้ให้ทำงานมากกว่า 1 ครั้งต่ออุปกรณ์ หากอุปกรณ์ที่เชื่อมต่อรองรับ ระบบควรส่งคืนอุปกรณ์ในเหตุการณ์ 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