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". القيم المحتملة هي قيم "media" سمة IPP ويمكن العثور عليها على صفحة IANA .

  • العرض

    الرقم

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

Printer

أماكن إقامة

  • الاسم

    سلسلة

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

  • المصدر

    PrinterSource

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

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

    سلسلة

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

PrinterSource

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

Enum

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

"POLICY"
تحدد أنه تمت إضافة الطابعة من خلال السياسة.

PrintJobInfo

أماكن إقامة

  • completionTime

    الرقم

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

  • creationTime

    الرقم

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

  • 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

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

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

"PrintED"
تحدِّد هذه السياسة أنّه تمت طباعة مهمة الطباعة بدون أي أخطاء.

PrintSettings

أماكن إقامة

  • اللون

    ColorMode

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

  • نُسخ

    الرقم

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

  • duplex

    DuplexMode

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

  • mediaSize

    MediaSize

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

الطُرق

getPrintJobs()

وعود 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

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

    (jobs: PrintJobInfo[]) => void

المرتجعات

  • Promise<PrintJobInfo[]>

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

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

فعاليات

onPrintJobFinished

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

يتم تنشيط الحدث عند انتهاء مهمة الطباعة. ويشمل ذلك أيًا من حالات الإنهاء: "تعذّر الإجراء" و"تم الإلغاء" و"تمت الطباعة".

المعلمات

  • رد الاتصال

    دالة

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

    (jobInfo: PrintJobInfo) => void