chrome.printingMetrics

תיאור

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

הרשאות

printingMetrics

זמינות

Chrome מגרסה 79 ואילך 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'. הערכים האפשריים הם של 'media' IPP וניתן למצוא אותו בדף IANA .

  • רוחב

    number

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

Printer

מאפיינים

  • שם

    מחרוזת

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

  • source

    PrinterSource

    מקור המדפסת.

  • URI

    מחרוזת

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

PrinterSource

מקור המדפסת.

Enum

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

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

PrintJobInfo

מאפיינים

  • completionTime

    number

    זמן השלמת המשימה (באלפיות שנייה אחרי תקופה של יוניקס [Unix epoch])

  • creationTime

    number

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

  • id [מזהה]

    מחרוזת

    מזהה המשימה.

  • numberOfPages

    number

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

  • מדפסת

    מדפסת

    פרטים על המדפסת שהדפיסה את המסמך.

  • printer_status

    PrinterStatus

    Chrome 85+

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

  • הגדרות

    PrintSettings

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

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

  • sourceId

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

    המזהה של המקור. המערכת תציג ערך של null אם המקור הוא print_PREVIEW או ANDROID_APP.

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

  • title

    מחרוזת

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

PrintJobSource

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

Enum

"print_PREVIEW"
מציין שהמשימה נוצרה מדף 'תצוגה מקדימה של הדפסה' ביוזמת המשתמש.

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

"תוסף"
מציין שהמשימה נוצרה על ידי תוסף דרך Chrome API.

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

PrintJobStatus

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

Enum

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

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

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

PrintSettings

מאפיינים

  • color [צבע]

    ColorMode

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

  • עותקים

    number

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

  • דופלקס

    DuplexMode

    מצב הדופלקס המבוקש.

  • mediaSize

    MediaSize

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

שיטות

getPrintJobs()

הבטחה 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

מחזירה את הרשימה של משימות ההדפסה שהסתיימו.

פרמטרים

  • קריאה חוזרת (callback)

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

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

    (jobs: PrintJobInfo[]) => void

החזרות

  • Promise<PrintJobInfo[]>

    Chrome מגרסה 96 ואילך

    הבטחות נתמכות במניפסט מגרסה V3 ואילך, אבל ניתנות קריאות חוזרות (callback) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.

אירועים

onPrintJobFinished

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

האירוע הופעל כשמשימת ההדפסה מסתיימת. זה כולל כל סטטוס של סיום: 'נכשל', 'בוטל' ו'מודפס'.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

    (jobInfo: PrintJobInfo) => void