chrome.printingMetrics

الوصف

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

الأذونات

printingMetrics

مدى التوفّر

الإصدار 79 من 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

"المستخدم"
تحدّد هذه السمة أنّ المستخدم هو من أضاف الطابعة.

"السياسة"
تحدّد ما إذا تمت إضافة الطابعة من خلال سياسة.

PrintJobInfo

الخصائص

  • completionTime

    الرقم

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

  • creationTime

    الرقم

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

  • id

    سلسلة

    معرّف الوظيفة.

  • numberOfPages

    الرقم

    تمثّل هذه السمة عدد الصفحات في المستند.

  • طابعة

    الطابعة

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

  • printer_status

    PrinterStatus

    الإصدار 85 من Chrome والإصدارات الأحدث

    تعرض هذه السمة حالة الطابعة.

  • الإعدادات

    PrintSettings

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

  • المصدر

    PrintJobSource

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

  • sourceId

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

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

  • تمثّل هذه السمة الحالة النهائية للوظيفة.

  • title

    سلسلة

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

PrintJobSource

تمثّل هذه السمة مصدر مهمة الطباعة.

Enum

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

‫"ANDROID_APP"
تحدّد هذه السمة أنّ مهمة البحث تم إنشاؤها من تطبيق Android.

"EXTENSION"
تحدّد هذه السمة أنّ الإضافة أنشأت مهمة من خلال Chrome API.

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

PrintJobStatus

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

Enum

"تعذّر التنفيذ"
يشير إلى أنّ مهمة الطباعة قد توقّفت بسبب حدوث خطأ ما.

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

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

PrintSettings

الخصائص

  • اللون

    ColorMode

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

  • النُسخ

    الرقم

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

  • duplex

    DuplexMode

    وضع الطباعة على الوجهين المطلوب.

  • mediaSize

    MediaSize

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

الطُرق

getPrintJobs()

الوعد 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

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

المعلمات

  • callback

    الدالة اختيارية

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

    (jobs: PrintJobInfo[]) => void

المرتجعات

  • Promise<PrintJobInfo[]>

    الإصدار 96 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

الفعاليات

onPrintJobFinished

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

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

المعلمات

  • callback

    دالة

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

    (jobInfo: PrintJobInfo) => void