browser.printingMetrics

תיאור

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

הרשאות

printingMetrics

זמינות

‫Chrome מגרסה 79 ואילך ‫browser.* ‎ מגרסה 148 של Chrome ‫ChromeOS בלבד נדרשת מדיניות

סוגים

ColorMode

טיפוסים בני מנייה (enum)

"BLACK_AND_WHITE"
מציין שנעשה שימוש במצב שחור-לבן.

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

DuplexMode

טיפוסים בני מנייה (enum)

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

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

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

MediaSize

מאפיינים

  • גובה

    number

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

  • vendorId

    מחרוזת

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

  • רוחב

    number

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

Printer

מאפיינים

  • שם

    מחרוזת

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

  • source

    PrinterSource

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

  • uri

    מחרוזת

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

PrinterSource

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

טיפוסים בני מנייה (enum)

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

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

PrintJobInfo

מאפיינים

  • completionTime

    number

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

  • creationTime

    number

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

  • id [מזהה]

    מחרוזת

    המזהה של המשימה.

  • numberOfPages

    number

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

  • מדפסת

    מדפסת

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

  • printer_status

    PrinterStatus

    ‫Chrome 85 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

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

  • הגדרות

    PrintSettings

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

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

  • sourceId

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

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

  • הסטטוס הסופי של המשימה.

  • title

    מחרוזת

    שם המסמך שהודפס.

PrintJobSource

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

טיפוסים בני מנייה (enum)

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

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

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

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

PrintJobStatus

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

טיפוסים בני מנייה (enum)

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

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

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

PrintSettings

מאפיינים

  • צבע

    ColorMode

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

  • עותקים

    number

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

  • דופלקס

    DuplexMode

    מצב הדפסה דו-צדדית שהתבקש.

  • mediaSize

    MediaSize

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

Methods

getPrintJobs()

browser.printingMetrics.getPrintJobs(): Promise<PrintJobInfo[]>

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

החזרות

  • Promise<PrintJobInfo[]>

    ‫Chrome 96 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

אירועים

onPrintJobFinished

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

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

פרמטרים