browser.printingMetrics

الوصف

استخدِم واجهة برمجة التطبيقات chrome.printingMetrics لجلب بيانات حول استخدام الطباعة.

الأذونات

printingMetrics

مدى التوفّر

الإصدار 79 من Chrome والإصدارات الأحدث متصفّح Chrome.* منذ الإصدار 148 من Chrome نظام التشغيل ChromeOS فقط يتطلب سياسة

الأنواع

ColorMode

Enum

"BLACK_AND_WHITE"
تشير إلى أنّه تم استخدام وضع الأبيض والأسود.

"COLOR"
تشير إلى أنّه تم استخدام وضع الألوان.

DuplexMode

Enum

‫"ONE_SIDED"
تشير إلى أنّه تم استخدام الطباعة على وجه واحد.

‫"TWO_SIDED_LONG_EDGE"
يحدّد أنّه تم استخدام الطباعة على الوجهين، مع القلب على الحافة الطويلة.

‫"TWO_SIDED_SHORT_EDGE"
تشير إلى أنّه تم استخدام الطباعة على الوجهين، مع القلب على الحافة القصيرة.

MediaSize

الخصائص

  • الارتفاع

    الرقم

    ارتفاع (بالميكرومتر) الوسائط المستخدَمة للطباعة

  • vendorId

    سلسلة

    المعرّف الذي يقدّمه المورّد، مثل "iso_a3_297x420mm" أو "na_index-3x5_3x5in". القيم المحتملة هي قيم سمة "الوسائط" في بروتوكول IPP ويمكن العثور عليها في صفحة IANA .

  • العرض

    الرقم

    عرض (بالميكرومتر) الوسائط المستخدَمة للطباعة

Printer

الخصائص

  • الاسم

    سلسلة

    الاسم المعروض للطابعة

  • المصدر

    PrinterSource

    مصدر الطابعة

  • معرّف الموارد المنتظم (URI)

    سلسلة

    المسار الكامل للطابعة يحتوي على البروتوكول واسم المضيف والمنفذ وقائمة الانتظار.

PrinterSource

مصدر الطابعة

Enum

"USER"
تشير إلى أنّ الطابعة تمت إضافتها من قِبل المستخدم.

"POLICY"
تشير إلى أنّه تمت إضافة الطابعة من خلال السياسة.

PrintJobInfo

الخصائص

  • completionTime

    الرقم

    وقت اكتمال المهمة (بالملي ثانية بعد حقبة يونكس)

  • creationTime

    الرقم

    وقت إنشاء المهمة (بالملي ثانية بعد حقبة يونكس)

  • id

    سلسلة

    رقم تعريف الوظيفة

  • numberOfPages

    الرقم

    عدد الصفحات في المستند

  • طابعة

    الطابعة

    معلومات عن الطابعة التي طبعت المستند

  • printer_status

    PrinterStatus

    الإصدار 85 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

    حالة الطابعة

  • الإعدادات

    PrintSettings

    إعدادات مهمة الطباعة

  • المصدر

    PrintJobSource

    المصدر الذي يوضّح من بدأ مهمة الطباعة

  • sourceId

    string اختياري

    رقم تعريف المصدر تكون القيمة فارغة إذا كان المصدر هو PRINT_PREVIEW أو ANDROID_APP.

  • الحالة النهائية للوظيفة

  • title

    سلسلة

    عنوان المستند الذي تمت طباعته

PrintJobSource

مصدر مهمة الطباعة

Enum

‫"PRINT_PREVIEW"
تشير إلى أنّه تم إنشاء المهمة من صفحة "معاينة الطباعة" التي بدأها المستخدم.

‫"ANDROID_APP"
تشير إلى أنّ المهمة تم إنشاؤها من تطبيق Android.

"EXTENSION"
تشير إلى أنّ مهمة الطباعة تم إنشاؤها بواسطة إضافة من خلال واجهة برمجة تطبيقات Chrome.

"ISOLATED_WEB_APP"
تشير إلى أنّ مهمة الطباعة تم إنشاؤها بواسطة تطبيق ويب معزول من خلال واجهة برمجة التطبيقات.

PrintJobStatus

تحدّد الحالة النهائية لمهمة الطباعة.

Enum

‫"FAILED"
تشير إلى أنّه تمّت مقاطعة مهمة الطباعة بسبب خطأ ما.

"CANCELED"
تشير إلى أنّ المستخدم أو واجهة برمجة التطبيقات قد ألغيا مهمة الطباعة.

"PRINTED"
يشير إلى أنّه تمت طباعة مهمة الطباعة بدون أي أخطاء.

PrintSettings

الخصائص

  • اللون

    ColorMode

    وضع الألوان المطلوب

  • نسخ

    الرقم

    عدد النُسخ المطلوبة

  • duplex

    DuplexMode

    الوضع المزدوج المطلوب

  • mediaSize

    MediaSize

    حجم الوسائط المطلوب

الطُرق

getPrintJobs()

browser.printingMetrics.getPrintJobs(): Promise<PrintJobInfo[]>

تعرض هذه الدالة قائمة بمهام الطباعة المكتملة.

المرتجعات

  • Promise<PrintJobInfo[]>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

الفعاليات

onPrintJobFinished

browser.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

يتم بدء الحدث عند انتهاء مهمة الطباعة. ويشمل ذلك أيًا من حالات الإنهاء: FAILED (تعذّر) وCANCELED (تم الإلغاء) وPRINTED (تمت الطباعة).

المعلمات

  • callback

    دالة

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

    (jobInfo: PrintJobInfo) => void