chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

תיאור

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

הרשאות

printerProvider

זמינות

‫Chrome מגרסה 44 ואילך

סוגים

PrinterInfo

מאפיינים

  • תיאור

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

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

  • id [מזהה]

    מחרוזת

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

  • שם

    מחרוזת

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

PrintError

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

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

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

"FAILED"
מציין שאירע כשל כללי.

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

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

PrintJob

מאפיינים

  • contentType

    מחרוזת

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

  • מסמך

    כתם

    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