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_297x420 มม." หรือ "na_index-3x5_3x5in" ค่าที่เป็นไปได้คือค่าของ "media" และดูแอตทริบิวต์ IPP ได้ที่หน้า IANA

  • ความกว้าง

    ตัวเลข

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

Printer

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

  • ชื่อ

    สตริง

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

  • source

    PrinterSource

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

  • URI

    สตริง

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

PrinterSource

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

ค่าแจกแจง

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

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

PrintJobInfo

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

  • completionTime

    ตัวเลข

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

  • creationTime

    ตัวเลข

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

  • id

    สตริง

    รหัสของงาน

  • numberOfPages

    ตัวเลข

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

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

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

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

  • printer_status

    PrinterStatus

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

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

  • การตั้งค่า

    PrintSettings

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

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

  • sourceId

    string ไม่บังคับ

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

  • สถานะ

    PrintJobStatus

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

  • title

    สตริง

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

PrintJobSource

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

ค่าแจกแจง

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

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

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

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

PrintJobStatus

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

ค่าแจกแจง

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

"ยกเลิก"
ระบุว่าผู้ใช้ยกเลิกงานพิมพ์หรือผ่าน 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 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

กิจกรรม

onPrintJobFinished

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (jobInfo: PrintJobInfo) => void