chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

شرح

chrome.printerProvider API رویدادهای مورداستفاده مدیر چاپ را برای پرسمان چاپگرهای تحت کنترل افزونه‌ها، پرسمان قابلیت‌های آن‌ها، و ارسال کارهای چاپ به این چاپگرها نشان می‌دهد.

اجازه‌ها

printerProvider

دردسترس بودن

Chrome نسخه ۴۴ به بالا

انواع

PrinterInfo

مشخصات

  • description

    رشته اختیاری

    توضیحات قابل‌خواندن برای انسان درباره چاپگر.

  • id

    رشته

    شناسه یکتای چاپگر.

  • نام

    رشته

    نام چاپگر قابل‌خواندن برای انسان.

PrintError

کدهای خطای برگردانده‌شده در پاسخ به رویداد onPrintRequested.

شمارشی

«OK»
مشخص می‌کند که عملیات با موفقیت تکمیل شده است.

«FAILED»
مشخص می‌کند که خطای عمومی رخ داده است.

«INVALID_TICKET»
مشخص می‌کند که بلیت چاپ نامعتبر است. برای مثال، بلیت با برخی قابلیت‌ها ناسازگار است یا افزونه نمی‌تواند همه تنظیمات بلیت را مدیریت کند.

«INVALID_DATA»
مشخص می‌کند که سند نامعتبر است. برای مثال، ممکن است داده‌ها خراب باشند یا قالب با افزونه ناسازگار باشد.

PrintJob

مشخصات

  • contentType

    رشته

    نوع محتوای سند. قالب‌های پشتیبانی‌شده عبارت‌اند از "application/pdf" و "image/pwg-raster".

  • سند

    حباب

    Blob حاوی داده‌های سند برای چاپ. قالب باید با contentType مطابقت داشته باشد.

  • printerId

    رشته

    شناسه چاپگری که باید کار را انجام دهد.

  • بلیت پشتیبانی : بلیت (درصورت محدودیت نویسه، یا اگر پس‌از تکرار اول)

    شیء

    چاپ بلیت در قالب CJT.

    مرجع CJT به‌عنوان منسوخ علامت‌گذاری شده است. این ویژگی فقط برای Google Cloud Print منسوخ شده است و برای چاپ ChromeOS منسوخ نشده است.

  • عنوان

    رشته

    عنوان کار چاپ.

رویدادها

onGetCapabilityRequested

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

وقتی مدیر چاپ قابلیت‌های چاپگر را درخواست می‌کند، رویداد فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

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

    • printerId

      رشته

    • resultCallback

      عملکرد

      پارامتر resultCallback به‌صورت زیر است: 

      (capabilities: object) => void

      • قابلیت‌ها

        شیء

        قابلیت‌های دستگاه در قالب CDD.

onGetPrintersRequested

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

رویداد زمانی فعال می‌شود که مدیر چاپ چاپگرهای ارائه‌شده توسط افزونه‌ها را درخواست کند.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (resultCallback: function) => void

    • resultCallback

      عملکرد

      پارامتر resultCallback به‌صورت زیر است: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome نسخه ۴۵ به بالا 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

وقتی مدیر چاپ اطلاعاتی درباره دستگاه USB که ممکن است چاپگر باشد درخواست می‌کند، رویداد فعال می‌شود.

توجه: برنامه نباید به این رویداد که بیش‌از یک‌بار در هر دستگاه اجرا می‌شود متکی باشد. اگر دستگاه متصل‌شده پشتیبانی شود، باید در رویداد onGetPrintersRequested برگردانده شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

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

    • دستگاه

      usb.Device

    • resultCallback

      عملکرد

      پارامتر resultCallback به‌صورت زیر است: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

رویداد زمانی فعال می‌شود که مدیر چاپ درخواست چاپ کند.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

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

    • printJob

      PrintJob

    • resultCallback

      عملکرد

      پارامتر resultCallback به‌صورت زیر است: 

      (result: PrintError) => void