الوصف
يمكنك استخدام واجهة برمجة التطبيقات chrome.printingMetrics
لاسترجاع البيانات المتعلّقة باستخدام الطباعة.
الأذونات
printingMetrics
مدى توفّر الخدمة
الأنواع
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
مصدر الطابعة.
-
uri
سلسلة
المسار الكامل للطابعة. يحتوي على البروتوكول واسم المضيف والمنفذ وقائمة الانتظار.
PrinterSource
مصدر الطابعة.
التعداد
"USER"
يحدد أنّه تمت إضافة الطابعة من قِبل المستخدم.
"POLICY"
يحدد أنه تمت إضافة الطابعة من خلال السياسة.
PrintJobInfo
أماكن إقامة
-
completionTime
الرقم
وقت إنجاز المهمة (بالمللي ثانية بعد حقبة يونكس).
-
creationTime
الرقم
وقت توفير الوظيفة (بالمللي ثانية بعد حقبة يونكس).
-
id
سلسلة
تمثّل هذه السمة معرّف الوظيفة.
-
numberOfPages
الرقم
عدد الصفحات في المستند.
-
طابعة
هذه السمة تعرض المعلومات حول الطابعة التي طبعت المستند.
-
printer_statusChrome 85 والإصدارات الأحدث
حالة الطابعة.
-
الإعدادات
إعدادات مهمة الطباعة.
-
source
المصدر الذي يعرض المستخدم الذي بدأ مهمة الطباعة
-
sourceId
سلسلة اختيارية
رقم تعريف المصدر. فارغة إذا كان المصدر Print_PREVIEW أو ANDROID_APP.
-
status
تمثّل هذه السمة الحالة النهائية للوظيفة.
-
title
سلسلة
تمثّل هذه السمة عنوان المستند الذي تمت طباعته.
PrintJobSource
مصدر مهمة الطباعة.
التعداد
"Print_PREVIEW"
يؤدي إلى إنشاء المهمة من صفحة "معاينة الطباعة" التي بدأها المستخدم.
"ANDROID_APP"
يحدد أن الوظيفة تم إنشاؤها من تطبيق Android.
"extension"
يحدد هذا الإعداد أن الوظيفة تم إنشاؤها من خلال الإضافة عبر Chrome API.
"ISOLATED_WEB_APP"
يحدد أن الوظيفة قد تم إنشاؤها بواسطة تطبيق ويب معزول عبر واجهة برمجة تطبيقات.
PrintJobStatus
تحدِّد هذه السياسة الحالة النهائية لمهمة الطباعة.
التعداد
"تعذّر"
يؤدي هذا الخيار إلى انقطاع مهمة الطباعة بسبب حدوث خطأ ما.
"CancelED" (تم الإلغاء)"
يحدد هذا الإعداد أن المستخدم قد ألغى مهمة الطباعة أو عبر واجهة برمجة التطبيقات.
"PrintED"
يحدد هذا الحقل أنه تمت طباعة مهمة الطباعة بدون أي أخطاء.
PrintSettings
أماكن إقامة
-
اللون
وضع الألوان المطلوب
-
نُسخ
الرقم
عدد النُسخ المطلوب.
-
duplex
الوضع المزدوج المطلوب.
-
mediaSize
حجم الوسائط المطلوب.
الطُرق
getPrintJobs()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
لعرض قائمة مهام الطباعة المنتهية.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(jobs: PrintJobInfo[]) => void
-
الوظائف
-
المرتجعات
-
Promise<PrintJobInfo[]>
Chrome 96 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
فعاليات
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
تم تنشيط الحدث عند انتهاء مهمة الطباعة. يشمل ذلك أيًّا من حالات الإنهاء: "تعذّر" و"تم الإلغاء" و"تمت الطباعة".
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(jobInfo: PrintJobInfo) => void
-
jobInfo
-