chrome.printingMetrics

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

printingMetrics

مدى التوفّر

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

الأنواع

ColorMode

تعداد

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

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

DuplexMode

تعداد

‫"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

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

تعداد

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

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

PrintJobInfo

الخصائص

  • completionTime

    الرقم

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

  • creationTime

    الرقم

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

  • id

    سلسلة

    رقم تعريف المهمة

  • numberOfPages

    الرقم

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

  • طابعة

    الطابعة

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

  • printer_status

    PrinterStatus

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

    حالة الطابعة

  • الإعدادات

    PrintSettings

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

  • المصدر

    PrintJobSource

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

  • sourceId

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

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

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

  • title

    سلسلة

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

PrintJobSource

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

تعداد

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

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

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

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

PrintJobStatus

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

تعداد

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

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

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

PrintSettings

الخصائص

  • اللون

    ColorMode

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

  • نُسخ

    الرقم

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

  • duplex

    DuplexMode

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

  • mediaSize

    MediaSize

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

الطُرق

getPrintJobs()

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

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

المعلمات

  • callback

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

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

    (jobs: PrintJobInfo[]) => void

المرتجعات

  • Promise<PrintJobInfo[]>

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

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

الفعاليات

onPrintJobFinished

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

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

المعلمات

  • callback

    دالة

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

    (jobInfo: PrintJobInfo) => void