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

    string

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

  • ความกว้าง

    ตัวเลข

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

Printer

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

  • ชื่อ

    string

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

  • source

    PrinterSource

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

  • uri

    string

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

PrinterSource

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

ค่าแจกแจง

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

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

PrintJobInfo

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

  • completionTime

    ตัวเลข

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

  • creationTime

    ตัวเลข

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

  • id

    string

    รหัสของงาน

  • numberOfPages

    ตัวเลข

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

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

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

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

  • printer_status

    PrinterStatus

    Chrome เวอร์ชัน 85 ขึ้นไป

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

  • การตั้งค่า

    PrintSettings

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

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

  • sourceId

    string ไม่บังคับ

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

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

  • title

    string

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

PrintJobSource

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

ค่าแจกแจง

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

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

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

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

PrintJobStatus

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

ค่าแจกแจง

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

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

"printED"
ระบุว่างานพิมพ์จะได้รับการพิมพ์โดยไม่มีข้อผิดพลาด

PrintSettings

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

  • สี

    ColorMode

    โหมดสีที่ต้องการ

  • สำเนา

    ตัวเลข

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

  • Duplex

    DuplexMode

    โหมด 2 ด้านที่ขอ

  • mediaSize

    MediaSize

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

วิธีการ

getPrintJobs()

สัญญา 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

พารามิเตอร์

  • Callback

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

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

    (jobs: PrintJobInfo[])=>void

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

  • Promise<PrintJobInfo[]>

    Chrome 96 ขึ้นไป

    Manifest V3 ขึ้นไปรองรับคำสัญญา แต่จะใช้โค้ดเรียกกลับเพื่อความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 ฟีเจอร์ในการเรียกใช้ฟังก์ชันเดียวกันได้ คำสัญญาจะยุติด้วยประเภทเดียวกันกับที่ส่งไปยังโค้ดเรียกกลับ

กิจกรรม

onPrintJobFinished

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (jobInfo: PrintJobInfo)=>void