chrome.printingMetrics

الوصف

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

  • العرض

    الرقم

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

Printer

أماكن إقامة

  • اسم

    سلسلة

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

  • source

    PrinterSource

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

  • uri

    سلسلة

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

PrinterSource

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

التعداد

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

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

PrintJobInfo

أماكن إقامة

  • completionTime

    الرقم

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

  • creationTime

    الرقم

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

  • id

    سلسلة

    تمثّل هذه السمة معرّف الوظيفة.

  • numberOfPages

    الرقم

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

  • طابعة

    طابعة

    هذه السمة تعرض المعلومات حول الطابعة التي طبعت المستند.

  • printer_status

    PrinterStatus

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

    حالة الطابعة.

  • الإعدادات

    PrintSettings

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

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

  • sourceId

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

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

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

  • title

    سلسلة

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

PrintJobSource

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

التعداد

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

"ANDROID_APP"
يحدد أن الوظيفة تم إنشاؤها من تطبيق Android.

"extension"
يحدد هذا الإعداد أن الوظيفة تم إنشاؤها من خلال الإضافة عبر Chrome API.

"ISOLATED_WEB_APP"
يحدد أن الوظيفة قد تم إنشاؤها بواسطة تطبيق ويب معزول عبر واجهة برمجة تطبيقات.

PrintJobStatus

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

التعداد

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

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

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

PrintSettings

أماكن إقامة

  • اللون

    ColorMode

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

  • نُسخ

    الرقم

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

  • duplex

    DuplexMode

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

  • mediaSize

    MediaSize

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

الطُرق

getPrintJobs()

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

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (jobs: PrintJobInfo[])=>void

المرتجعات

  • Promise<PrintJobInfo[]>

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

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

فعاليات

onPrintJobFinished

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (jobInfo: PrintJobInfo)=>void