chrome.printingMetrics

תיאור

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

הרשאות

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. הערכים האפשריים הם ערכים של מאפיין IPP ‏'media', ואפשר למצוא אותם בדף IANA .

  • רוחב

    number

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

Printer

מאפיינים

  • שם

    מחרוזת

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

  • source

    PrinterSource

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

  • uri

    מחרוזת

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

PrinterSource

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

Enum

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

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

PrintJobInfo

מאפיינים

  • completionTime

    number

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

  • creationTime

    number

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

  • id [מזהה]

    מחרוזת

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

  • numberOfPages

    number

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

  • מדפסת

    מדפסת

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

  • printer_status

    PrinterStatus

    ‫Chrome 85 ואילך

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

  • הגדרות

    PrintSettings

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

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

  • sourceId

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

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

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

  • title

    מחרוזת

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

PrintJobSource

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

Enum

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

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

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

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

PrintJobStatus

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

Enum

‫"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 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

אירועים

onPrintJobFinished

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

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

פרמטרים