תיאור
כדי לאחזר נתונים לגבי השימוש בהדפסה, משתמשים ב-API chrome.printingMetrics
.
הרשאות
printingMetrics
זמינות
סוגים
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
מקור המדפסת.
-
URI
מחרוזת
הנתיב המלא של המדפסת. מכיל פרוטוקול, שם מארח, יציאה ותור.
PrinterSource
מקור המדפסת.
Enum
"USER"
מציין שהמדפסת נוספה על ידי המשתמש.
"מדיניות"
מציין שהמדפסת נוספה באמצעות מדיניות.
PrintJobInfo
מאפיינים
-
completionTime
number
זמן השלמת המשימה (באלפיות שנייה אחרי תקופה של יוניקס [Unix epoch])
-
creationTime
number
הזמן של יצירת המשימה (באלפיות שנייה אחרי תקופה של יוניקס [Unix epoch])
-
id [מזהה]
מחרוזת
מזהה המשימה.
-
numberOfPages
number
מספר הדפים במסמך.
-
מדפסת
פרטים על המדפסת שהדפיסה את המסמך.
-
printer_statusChrome 85+
סטטוס המדפסת.
-
הגדרות
ההגדרות של משימת ההדפסה.
-
source
מקור שמוצג בו מי שיזם את משימת ההדפסה.
-
sourceId
מחרוזת אופציונלי
המזהה של המקור. המערכת תציג ערך של null אם המקור הוא print_PREVIEW או ANDROID_APP.
-
status
הסטטוס הסופי של המשרה.
-
title
מחרוזת
כותרת המסמך שהודפס.
PrintJobSource
המקור של משימת ההדפסה.
Enum
"print_PREVIEW"
מציין שהמשימה נוצרה מדף 'תצוגה מקדימה של הדפסה' ביוזמת המשתמש.
"ANDROID_APP"
מציין שהמשימה נוצרה מאפליקציה ל-Android.
"תוסף"
מציין שהמשימה נוצרה על ידי תוסף דרך Chrome API.
"ISOLATED_WEB_APP"
המציין שהמשימה נוצרה על ידי אפליקציית אינטרנט מבודדת (IWA) באמצעות API.
PrintJobStatus
מציין את הסטטוס הסופי של משימת ההדפסה.
Enum
"נכשל"
מציין שמשימת ההדפסה הופסקה עקב שגיאה כלשהי.
"בוטל"
מציין שמשימת ההדפסה בוטלה על ידי המשתמש או דרך API.
'מודפס'
מציין שמשימת ההדפסה הודפסה ללא שגיאות.
PrintSettings
מאפיינים
-
color [צבע]
מצב הצבע המבוקש.
-
עותקים
number
מספר העותקים המבוקש.
-
דופלקס
מצב הדופלקס המבוקש.
-
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
-
jobInfo
-