chrome.printingMetrics

คำอธิบาย

ใช้ chrome.printingMetrics API เพื่อดึงข้อมูลเกี่ยวกับการใช้งานการพิมพ์

สิทธิ์

printingMetrics

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

Chrome 79 ขึ้นไป ChromeOS เท่านั้น ต้องใช้นโยบาย

ประเภท

ColorMode

ค่าแจกแจง

"BLACK_AND_WHITE"
ระบุว่าใช้โหมดขาวดำ

"COLOR"
ระบุว่าใช้โหมดสี

DuplexMode

ค่าแจกแจง

"ONE_SIDED"
ระบุว่าใช้การพิมพ์ด้านเดียว

"TWO_SIDED_LONG_EDGE"
ระบุว่าใช้การพิมพ์แบบ 2 ด้านโดยพลิกตามขอบด้านยาว

"TWO_SIDED_SHORT_EDGE"
ระบุว่ามีการใช้การพิมพ์แบบ 2 ด้าน โดยพลิกตามขอบด้านสั้น

MediaSize

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

  • ส่วนสูง

    ตัวเลข

    ความสูง (เป็นไมโครเมตร) ของสื่อที่ใช้ในการพิมพ์

  • vendorId

    สตริง

    รหัสที่ผู้ให้บริการระบุ เช่น "iso_a3_297x420mm" หรือ "na_index-3x5_3x5in" ค่าที่เป็นไปได้คือค่าของแอตทริบิวต์ IPP "media" และดูได้ในหน้า IANA

  • ความกว้าง

    ตัวเลข

    ความกว้าง (เป็นไมโครเมตร) ของสื่อที่ใช้สำหรับการพิมพ์

Printer

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

  • ชื่อ

    สตริง

    ชื่อที่แสดงของเครื่องพิมพ์

  • source

    PrinterSource

    แหล่งที่มาของเครื่องพิมพ์

  • uri

    สตริง

    เส้นทางแบบเต็มของเครื่องพิมพ์ ประกอบด้วยโปรโตคอล ชื่อโฮสต์ พอร์ต และคิว

PrinterSource

แหล่งที่มาของเครื่องพิมพ์

ค่าแจกแจง

"USER"
ระบุว่าผู้ใช้เป็นผู้เพิ่มเครื่องพิมพ์

"POLICY"
ระบุว่ามีการเพิ่มเครื่องพิมพ์ผ่านนโยบาย

PrintJobInfo

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

  • completionTime

    ตัวเลข

    เวลาที่งานเสร็จสมบูรณ์ (เป็นมิลลิวินาทีหลังจากเวลา Unix Epoch)

  • creationTime

    ตัวเลข

    เวลาการสร้างงาน (เป็นมิลลิวินาทีหลังจากเวลา Unix Epoch)

  • id

    สตริง

    รหัสของงาน

  • numberOfPages

    ตัวเลข

    จำนวนหน้าในเอกสาร

  • เครื่องพิมพ์

    เครื่องพิมพ์

    ข้อมูลเกี่ยวกับเครื่องพิมพ์ที่พิมพ์เอกสาร

  • printer_status

    PrinterStatus

    Chrome 85 ขึ้นไป

    สถานะของเครื่องพิมพ์

  • การตั้งค่า

    PrintSettings

    การตั้งค่างานพิมพ์

  • แหล่งที่มาที่แสดงผู้เริ่มงานพิมพ์

  • sourceId

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

    รหัสของแหล่งที่มา เป็น Null หากแหล่งที่มาคือ PRINT_PREVIEW หรือ ANDROID_APP

  • สถานะ

    PrintJobStatus

    สถานะสุดท้ายของงาน

  • title

    สตริง

    ชื่อของเอกสารที่พิมพ์

PrintJobSource

แหล่งที่มาของงานพิมพ์

ค่าแจกแจง

"PRINT_PREVIEW"
ระบุว่างานสร้างขึ้นจากหน้าตัวอย่างก่อนพิมพ์ที่ผู้ใช้เริ่ม

"ANDROID_APP"
ระบุว่างานสร้างขึ้นจากแอป Android

"EXTENSION"
ระบุว่างานสร้างขึ้นโดยส่วนขยายผ่าน Chrome API

"ISOLATED_WEB_APP"
ระบุว่างานสร้างขึ้นโดย Isolated Web App ผ่าน API

PrintJobStatus

ระบุสถานะสุดท้ายของงานพิมพ์

ค่าแจกแจง

"ไม่สำเร็จ"
ระบุว่างานพิมพ์ถูกขัดจังหวะเนื่องจากข้อผิดพลาดบางอย่าง

"ยกเลิกแล้ว"
ระบุว่าผู้ใช้หรือ API ยกเลิกงานพิมพ์

"พิมพ์แล้ว"
ระบุว่างานพิมพ์พิมพ์เสร็จแล้วโดยไม่มีข้อผิดพลาด

PrintSettings

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

  • สี

    ColorMode

    โหมดสีที่ขอ

  • สำเนา

    ตัวเลข

    จำนวนสำเนาที่ขอ

  • Duplex

    DuplexMode

    โหมดดูเพล็กซ์ที่ขอ

  • mediaSize

    MediaSize

    ขนาดสื่อที่ขอ

เมธอด

getPrintJobs()

Promise 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

แสดงรายการงานพิมพ์ที่เสร็จสมบูรณ์แล้ว

พารามิเตอร์

  • callback

    ฟังก์ชัน ไม่บังคับ

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

    (jobs: PrintJobInfo[]) => void

การคืนสินค้า

กิจกรรม

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

เหตุการณ์ที่เริ่มทำงานเมื่องานพิมพ์เสร็จสิ้น ซึ่งรวมถึงสถานะการสิ้นสุดทั้งหมด ได้แก่ ไม่สำเร็จ ยกเลิก และพิมพ์แล้ว

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (jobInfo: PrintJobInfo) => void