คำอธิบาย
ใช้ chrome.printingMetrics
API เพื่อดึงข้อมูลเกี่ยวกับการใช้การพิมพ์
สิทธิ์
printingMetrics
ความพร้อมใช้งาน
ประเภท
ColorMode
ค่าแจกแจง
"BLACK_AND_WHITE"
ระบุว่ามีการใช้โหมดขาวดำ
"COLOR"
ระบุว่ามีการใช้โหมดสี
DuplexMode
ค่าแจกแจง
"ONE_SIDED"
ระบุว่าใช้การพิมพ์แบบด้านเดียว
"TWO_SIDED_LONG_EDGE"
ระบุว่ามีการใช้การพิมพ์แบบ 2 ด้าน โดยพลิกด้านตามแนวยาว
"TWO_SIDED_SHORT_EDGE"
ระบุว่ามีการใช้การพิมพ์ 2 ด้าน โดยพลิกไปที่ขอบด้านสั้น
MediaSize
พร็อพเพอร์ตี้
-
ส่วนสูง
ตัวเลข
ความสูงของสื่อ (หน่วยเป็นไมโครเมตร) ของสื่อที่ใช้สำหรับการพิมพ์
-
vendorId
string
รหัสที่ผู้ให้บริการระบุ เช่น "iso_a3_297x420 มม." หรือ "na_index-3x5_3x5in" ค่าที่เป็นไปได้คือค่าของแอตทริบิวต์ IPP "media" ซึ่งพบได้ในหน้า IANA
-
ความกว้าง
ตัวเลข
ความกว้าง (เป็นไมโครเมตร) ของสื่อที่ใช้สำหรับการพิมพ์
Printer
พร็อพเพอร์ตี้
-
ชื่อ
string
ชื่อที่แสดงของเครื่องพิมพ์
-
source
แหล่งที่มาของเครื่องพิมพ์
-
uri
string
เส้นทางแบบเต็มสำหรับเครื่องพิมพ์ ประกอบด้วยโปรโตคอล ชื่อโฮสต์ พอร์ต และคิว
PrinterSource
แหล่งที่มาของเครื่องพิมพ์
ค่าแจกแจง
"USER"
ระบุว่าผู้ใช้เพิ่มเครื่องพิมพ์นี้
"POLICY"
ระบุว่าเพิ่มเครื่องพิมพ์ผ่านนโยบาย
PrintJobInfo
พร็อพเพอร์ตี้
-
completionTime
ตัวเลข
เวลาที่งานเสร็จสมบูรณ์ (หน่วยเป็นมิลลิวินาทีหลังจากผ่าน Epoch ของ Unix)
-
creationTime
ตัวเลข
เวลาที่สร้างงาน (เป็นมิลลิวินาทีหลังจากผ่าน Epoch ของ Unix)
-
id
string
รหัสของงาน
-
numberOfPages
ตัวเลข
จำนวนหน้าในเอกสาร
-
เครื่องพิมพ์
ข้อมูลเกี่ยวกับเครื่องพิมพ์ที่พิมพ์เอกสาร
-
printer_statusChrome เวอร์ชัน 85 ขึ้นไป
สถานะของเครื่องพิมพ์
-
การตั้งค่า
การตั้งค่าของงานพิมพ์
-
source
แหล่งที่มาที่แสดงว่าใครเป็นผู้ริเริ่มงานพิมพ์
-
sourceId
string ไม่บังคับ
รหัสของแหล่งที่มา มีค่า Null หากแหล่งที่มาคือ PRINT_PREVIEW หรือ ANDROID_APP
-
status
สถานะสุดท้ายของงาน
-
title
string
ชื่อเอกสารที่พิมพ์
PrintJobSource
แหล่งที่มาของงานพิมพ์
ค่าแจกแจง
"PRINT_PREVIEW"
ระบุว่าสร้างงานจากหน้าตัวอย่างก่อนพิมพ์ที่ผู้ใช้เริ่มต้น
"ANDROID_APP"
ระบุว่างานสร้างขึ้นจากแอป Android
"EXTENSION"
ระบุว่างานสร้างขึ้นโดยส่วนขยายผ่าน Chrome API
"ISOLATED_WEB_APP"
ระบุว่างานสร้างขึ้นโดย Isolated Web App ผ่าน API
PrintJobStatus
ระบุสถานะสุดท้ายของงานพิมพ์
ค่าแจกแจง
"FAILED"
ระบุว่างานพิมพ์ถูกขัดจังหวะเนื่องจากข้อผิดพลาดบางอย่าง
"CANCELED"
ระบุว่าผู้ใช้ยกเลิกงานพิมพ์หรือผ่าน API
"printED"
ระบุว่างานพิมพ์จะได้รับการพิมพ์โดยไม่มีข้อผิดพลาด
PrintSettings
พร็อพเพอร์ตี้
-
สี
โหมดสีที่ต้องการ
-
สำเนา
ตัวเลข
จำนวนสำเนาที่ขอ
-
Duplex
โหมด 2 ด้านที่ขอ
-
mediaSize
ขนาดสื่อที่ขอ
วิธีการ
getPrintJobs()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
แสดงรายการงานพิมพ์ที่เสร็จแล้ว
พารามิเตอร์
-
Callback
ฟังก์ชัน ไม่บังคับ
พารามิเตอร์
callback
มีลักษณะดังนี้(jobs: PrintJobInfo[]) => void
-
งาน
-
การคืนสินค้า
-
Promise<PrintJobInfo[]>
Chrome 96 ขึ้นไปPromiss รองรับเฉพาะไฟล์ Manifest V3 ขึ้นไป ส่วนแพลตฟอร์มอื่นๆ จะต้องใช้โค้ดเรียกกลับ
กิจกรรม
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
เหตุการณ์เริ่มทำงานเมื่องานพิมพ์เสร็จสิ้น ซึ่งรวมถึงสถานะการสิ้นสุด ได้แก่ ล้มเหลว ยกเลิก และพิมพ์
พารามิเตอร์
-
Callback
ฟังก์ชัน
พารามิเตอร์
callback
มีลักษณะดังนี้(jobInfo: PrintJobInfo) => void
-
jobInfo
-