chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

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

สิทธิ์

printerProvider

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

Chrome 44 ขึ้นไป

ประเภท

PrinterInfo

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

  • คำอธิบาย

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

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

  • id

    สตริง

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

  • name

    สตริง

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

PrintError

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

ค่าแจกแจง

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

"FAILED"
ระบุว่าเกิดความล้มเหลวทั่วไป

"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