chrome.printerProvider

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

תיאור

‫chrome.printerProvider API חושף אירועים שמשמשים את מרכז ההדפסה לשליחת שאילתות למדפסות שנשלטות על ידי תוספים, כדי לשאול על היכולות שלהן ולשלוח אליהן משימות הדפסה.

הרשאות

printerProvider

זמינות

‫Chrome 44 ואילך

סוגים

PrinterInfo

מאפיינים

  • תיאור

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

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

  • id [מזהה]

    מחרוזת

    מזהה מדפסת ייחודי.

  • שם

    מחרוזת

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

PrintError

קודי שגיאה שמוחזרים בתגובה לאירוע onPrintRequested.

ספירה

‫OK
מציין שהפעולה הושלמה בהצלחה.

‫FAILED
מציין שהתרחש כשל כללי.

‫INVALID_TICKET
מציין שהכרטיס המודפס לא תקין. לדוגמה, הכרטיס לא עקבי עם חלק מהיכולות, או שהתוסף לא יכול לטפל בכל ההגדרות מהכרטיס.

‫INVALID_DATA
מציין שהמסמך לא תקין. לדוגמה, יכול להיות שהנתונים פגומים או שהפורמט לא תואם לתוסף.

PrintJob

מאפיינים

  • contentType

    מחרוזת

    סוג התוכן של המסמך. הפורמטים הנתמכים הם "application/pdf" ו-"image/pwg-raster".

  • מסמך

    Blob

    אובייקט Blob שמכיל את נתוני המסמך להדפסה. הפורמט חייב להיות contentType.

  • printerId

    מחרוזת

    המזהה של המדפסת שאמורה לטפל בעבודה.

  • כרטיס

    אובייקט

    הדפסת כרטיס בפורמט CJT.

    ההפניה ל-CJT מסומנת כהפניה שיצאה משימוש. היא הוצאה משימוש רק ב-Google Cloud Print, ולא בהדפסה ב-ChromeOS.

  • title

    מחרוזת

    השם של משימת ההדפסה.

אירועים

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

אירוע שמופעל כשמנהל ההדפסה מבקש את היכולות של המדפסת.

פרמטרים

  • callback

    פונקציה

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

    (printerId: string, resultCallback: function) => void

    • printerId

      מחרוזת

    • resultCallback

      פונקציה

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

      (capabilities: object) => void

      • יכולות

        אובייקט

        יכולות המכשיר בפורמט CDD.

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

אירוע שמופעל כשמנהל ההדפסה מבקש מדפסות שסופקו על ידי תוספים.

פרמטרים

  • callback

    פונקציה

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

    (resultCallback: function) => void

    • resultCallback

      פונקציה

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

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

‫Chrome 45 ואילך 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

אירוע שמופעל כשמנהל ההדפסה מבקש מידע על מכשיר USB שעשוי להיות מדפסת.

הערה: אפליקציה לא צריכה להסתמך על כך שהאירוע הזה יופעל יותר מפעם אחת לכל מכשיר. אם המכשיר המחובר נתמך, הוא יוחזר באירוע onGetPrintersRequested.

פרמטרים

  • callback

    פונקציה

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

    (device: usb.Device, resultCallback: function) => void

    • מכשיר

      usb.Device

    • resultCallback

      פונקציה

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

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

האירוע מופעל כשמנהל ההדפסה מבקש להדפיס.

פרמטרים

  • callback

    פונקציה

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

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      פונקציה

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

      (result: PrintError) => void