chrome.printingMetrics

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

משתמשים ב-chrome.printingMetrics API כדי לאחזר נתונים על השימוש בהדפסה.

הרשאות

printingMetrics

זמינות

‫Chrome 79 ואילך ‫ChromeOS בלבד נדרשת מדיניות

סוגים

ColorMode

ספירה

‫BLACK_AND_WHITE
מציין שהשתמשו במצב שחור-לבן.

‫"COLOR"
מציין שהשתמשו במצב צבע.

DuplexMode

ספירה

‫ONE_SIDED
מציין שהשתמשו בהדפסה חד-צדדית.

‫"TWO_SIDED_LONG_EDGE"
מציין שההדפסה הייתה דו-צדדית, עם היפוך בצד הארוך.

‫"TWO_SIDED_SHORT_EDGE"
הדפסה דו-צדדית עם היפוך בצד הקצר.

MediaSize

מאפיינים

  • גובה

    number

    הגובה (במיקרומטרים) של המדיה שמשמשת להדפסה.

  • vendorId

    מחרוזת

    מזהה שסופק על ידי הספק, למשל iso_a3_297x420mm או na_index-3x5_3x5in. הערכים האפשריים הם ערכים של מאפיין IPP מסוג media, ואפשר למצוא אותם בדף של IANA .

  • רוחב

    number

    הרוחב (במיקרומטרים) של המדיה שמשמשת להדפסה.

Printer

מאפיינים

  • שם

    מחרוזת

    השם המוצג של המדפסת.

  • source

    PrinterSource

    המקור של המדפסת.

  • uri

    מחרוזת

    הנתיב המלא של המדפסת. מכיל פרוטוקול, שם מארח, יציאה ותור.

PrinterSource

המקור של המדפסת.

ספירה

‫USER
מציין שהמדפסת נוספה על ידי משתמש.

‫POLICY
מציין שהמדפסת נוספה באמצעות מדיניות.

PrintJobInfo

מאפיינים

  • completionTime

    number

    זמן השלמת העבודה (באלפיות השנייה מאז ראשית זמן יוניקס).

  • creationTime

    number

    הזמן שבו נוצרה המשימה (באפסיות השנייה מאז ראשית זמן יוניקס).

  • id [מזהה]

    מחרוזת

    המזהה של העבודה.

  • numberOfPages

    number

    מספר הדפים במסמך.

  • מדפסת

    מדפסת

    המידע על המדפסת שבה הודפס המסמך.

  • printer_status

    PrinterStatus

    ‫Chrome 85 ואילך

    הסטטוס של המדפסת.

  • הגדרות

    PrintSettings

    ההגדרות של משימת ההדפסה.

  • המקור שמראה מי יזם את משימת ההדפסה.

  • sourceId

    מחרוזת אופציונלי

    מזהה המקור. הערך הוא Null אם המקור הוא PRINT_PREVIEW או ANDROID_APP.

  • הסטטוס הסופי של העבודה.

  • title

    מחרוזת

    הכותרת של המסמך שהודפס.

PrintJobSource

המקור של משימת ההדפסה.

ספירה

‫'PRINT_PREVIEW'
מציין שהעבודה נוצרה מדף התצוגה המקדימה לפני ההדפסה שהופעל על ידי המשתמש.

‫"ANDROID_APP"
מציין שהפעולה נוצרה מאפליקציית Android.

‫EXTENSION
מציין שהעבודה נוצרה על ידי תוסף באמצעות Chrome API.

‫ISOLATED_WEB_APP
מציין שהעבודה נוצרה על ידי אפליקציית אינטרנט מבודדת באמצעות API.

PrintJobStatus

מציין את הסטטוס הסופי של עבודת ההדפסה.

ספירה

FAILED
מציין שעבודת ההדפסה הופסקה בגלל שגיאה.

‫CANCELED
מציין שמשימת ההדפסה בוטלה על ידי המשתמש או באמצעות API.

PRINTED
מציין שמשימת ההדפסה הודפסה ללא שגיאות.

PrintSettings

מאפיינים

  • צבע

    ColorMode

    מצב הצבע המבוקש.

  • עותקים

    number

    מספר העותקים המבוקש.

  • דופלקס

    DuplexMode

    מצב הדפסה משני צידי הדף שנדרש.

  • mediaSize

    MediaSize

    גודל המדיה המבוקש.

Methods

getPrintJobs()

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

הפונקציה מחזירה את רשימת משימות ההדפסה שהסתיימו.

פרמטרים

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (jobs: PrintJobInfo[]) => void

החזרות

  • Promise<PrintJobInfo[]>

    ‫Chrome 96 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

onPrintJobFinished

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

האירוע מופעל כשמשימת ההדפסה מסתיימת. הסטטוסים האלה כוללים את כל סטטוסי הסיום: FAILED, ‏ CANCELED ו-PRINTED.

פרמטרים