chrome.printerProvider

תיאור

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

הרשאות

printerProvider

זמינות

Chrome 44 ואילך

סוגים

PrinterInfo

מאפיינים

  • תיאור

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

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

  • id [מזהה]

    מחרוזת

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

  • שם

    מחרוזת

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

PrintError

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

Enum

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

"נכשל"
מציין שאירעה תקלה כללית.

"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