chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

الوصف

تعرض واجهة برمجة التطبيقات chrome.printerProvider الأحداث التي يستخدمها "مدير الطباعة" للبحث عن الطابعات التي تتحكّم فيها الإضافات، وللبحث عن إمكاناتها، ولإرسال مهام الطباعة إلى هذه الطابعات.

الأذونات

printerProvider

مدى التوفّر

Chrome 44 والإصدارات الأحدث

الأنواع

PrinterInfo

الخصائص

  • الوصف

    سلسلة اختيارية

    وصف الطابعة الذي يمكن لشخص عادي قراءته

  • id

    سلسلة

    المعرّف الفريد للطابعة

  • الاسم

    سلسلة

    اسم الطابعة الذي يمكن لشخص عادي قراءته

PrintError

رموز الأخطاء التي تم عرضها استجابةً للحدث onPrintRequested.

تعداد

"حسنًا"
تُستخدَم لتحديد أنّ العملية اكتملت بنجاح.

‫"FAILED"
تُستخدَم للإشارة إلى حدوث خطأ عام.

‫"INVALID_TICKET"
تُستخدَم لتحديد أنّ تذكرة الطباعة غير صالحة. على سبيل المثال، لا تتوافق التذكرة مع بعض الإمكانات، أو لا يمكن للإضافة التعامل مع جميع الإعدادات من التذكرة.

‫"INVALID_DATA"
تحدّد هذه السمة أنّ المستند غير صالح. على سبيل المثال، قد تكون البيانات تالفة أو قد يكون التنسيق غير متوافق مع الإضافة.

PrintJob

الخصائص

  • contentType

    سلسلة

    نوع محتوى المستند التنسيقات المتوافقة هي "application/pdf" و"image/pwg-raster".

  • مستند

    بلوب

    كائن ثنائي كبير يحتوي على بيانات المستند المطلوب طباعته. يجب أن يتطابق التنسيق مع contentType.

  • printerId

    سلسلة

    رقم تعريف الطابعة التي يجب أن تعالج مهمة الطباعة

  • طلب دعم

    عنصر

    طباعة التذكرة بتنسيق CJT

    تم وضع علامة على مرجع CJT على أنّه متوقّف نهائيًا. تم إيقافها نهائيًا لخدمة الطباعة السحابية من Google فقط، ولكنها لا تزال متاحة للطباعة على ChromeOS.

  • title

    سلسلة

    تمثّل هذه السمة عنوان مهمة الطباعة.

الفعاليات

onGetCapabilityRequested

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

يتم تشغيل الحدث عندما يطلب مدير الطباعة إمكانات الطابعة.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

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

    • printerId

      سلسلة

    • resultCallback

      دالة

      تظهر المَعلمة resultCallback على النحو التالي: 

      (capabilities: object) => void

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