chrome.printerProvider

تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex

توضیحات

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

مجوزها

printerProvider

در دسترس بودن

کروم ۴۴+

انواع

PrinterInfo

خواص

  • توضیحات

    رشته اختیاری

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

  • شناسه

    رشته

    شناسه منحصر به فرد چاپگر.

  • نام

    رشته

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

PrintError

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

شمارشی

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

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

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

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

PrintJob

خواص

  • نوع محتوا

    رشته

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

  • سند

    لکه

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

  • شناسه چاپگر

    رشته

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

  • بلیط

    شیء

    بلیط را با فرمت CJT چاپ کنید.

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

  • عنوان

    رشته

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

رویدادها

onGetCapabilityRequested

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

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

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

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

    • شناسه چاپگر

      رشته

    • نتیجه فراخوانی برگشتی

      تابع

      پارامتر resultCallback به شکل زیر است: 

      (capabilities: object) => void

      • قابلیت‌ها

        شیء

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

onGetPrintersRequested

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

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

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (resultCallback: function) => void

    • نتیجه فراخوانی برگشتی

      تابع

      پارامتر resultCallback به شکل زیر است: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

کروم ۴۵+
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

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

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

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

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

onPrintRequested

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

این رویداد زمانی رخ می‌دهد که مدیر چاپ، درخواست چاپ کند.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

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

    • چاپ جاب

      کار چاپ

    • نتیجه فراخوانی برگشتی

      تابع

      پارامتر resultCallback به شکل زیر است: 

      (result: PrintError) => void