chrome.printingMetrics

تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex

توضیحات

از API chrome.printingMetrics برای دریافت داده‌های مربوط به میزان استفاده از چاپ استفاده کنید.

مجوزها

printingMetrics

در دسترس بودن

فقط Chrome نسخه ۷۹+ سیستم عامل Chrome نیاز به خط‌مشی دارد

انواع

ColorMode

شمارشی

«سیاه_و_سفید»
مشخص می‌کند که از حالت سیاه و سفید استفاده شده است.

"رنگ"
مشخص می‌کند که از حالت رنگ استفاده شده است.

DuplexMode

شمارشی

«یک‌طرفه»
مشخص می‌کند که از چاپ یک‌طرفه استفاده شده است.

"لبه_بلند_دو_طرفه"
مشخص می‌کند که از چاپ دو طرفه استفاده شده است، و لبه بلند آن برگردانده شده است.

«لبه_کوتاه_دو_طرفه»
مشخص می‌کند که از چاپ دو طرفه استفاده شده است، و از لبه کوتاه برگردانده شده است.

MediaSize

خواص

  • ارتفاع

    شماره

    ارتفاع (برحسب میکرومتر) ماده مورد استفاده برای چاپ.

  • شناسه فروشنده

    رشته

    شناسه ارائه شده توسط فروشنده، مثلاً "iso_a3_297x420mm" یا "na_index-3x5_3x5in". مقادیر ممکن، مقادیر ویژگی IPP "media" هستند و در صفحه IANA قابل مشاهده می‌باشند.

  • عرض

    شماره

    عرض (برحسب میکرومتر) رسانه مورد استفاده برای چاپ.

Printer

خواص

  • نام

    رشته

    نام چاپگر نمایش داده شده.

  • منبع چاپگر.

  • یوری

    رشته

    مسیر کامل چاپگر. شامل پروتکل، نام میزبان، پورت و صف انتظار.

PrinterSource

منبع چاپگر.

شمارشی

"کاربر"
مشخص می‌کند که چاپگر توسط کاربر اضافه شده است.

«سیاست»
مشخص می‌کند که چاپگر از طریق خط‌مشی اضافه شده است.

PrintJobInfo

خواص

  • زمان تکمیل

    شماره

    زمان تکمیل کار (بر حسب میلی‌ثانیه پس از دوره یونیکس).

  • زمان ایجاد

    شماره

    زمان ایجاد شغل (به میلی‌ثانیه پس از عصر یونیکس).

  • شناسه

    رشته

    شناسه شغل.

  • تعداد صفحات

    شماره

    تعداد صفحات موجود در سند.

  • چاپگر

    چاپگر

    اطلاعات مربوط به چاپگری که سند را چاپ کرده است.

  • وضعیت_چاپگر

    وضعیت چاپگر

    کروم ۸۵+

    وضعیت چاپگر.

  • تنظیمات

    تنظیمات چاپ

    تنظیمات کار چاپ.

  • منبعی که نشان می‌دهد چه کسی کار چاپ را آغاز کرده است.

  • شناسه منبع

    رشته اختیاری

    شناسه منبع. اگر منبع PRINT_PREVIEW یا ANDROID_APP باشد، مقدار null خواهد بود.

  • وضعیت نهایی کار.

  • عنوان

    رشته

    عنوان سندی که چاپ شده است.

PrintJobSource

منبع کار چاپ.

شمارشی

"پیش‌نمایش چاپ"
مشخص می‌کند که کار از صفحه پیش‌نمایش چاپ که توسط کاربر آغاز شده است، ایجاد شده است.

«برنامه اندروید»
مشخص می‌کند که این کار از یک برنامه اندروید ایجاد شده است.

"امتداد"
مشخص می‌کند که این کار توسط افزونه از طریق API کروم ایجاد شده است.

"اپلیکیشن وب ایزوله"
مشخص می‌کند که این کار توسط یک برنامه وب ایزوله از طریق API ایجاد شده است.

PrintJobStatus

وضعیت نهایی کار چاپ را مشخص می‌کند.

شمارشی

«شکست خورد»
مشخص می‌کند که کار چاپ به دلیل برخی خطاها متوقف شده است.

«لغو شد»
مشخص می‌کند که کار چاپ توسط کاربر یا از طریق API لغو شده است.

«چاپ‌شده»
مشخص می‌کند که کار چاپ بدون هیچ خطایی چاپ شده است.

PrintSettings

خواص

  • حالت رنگ درخواستی.

  • نسخه‌ها

    شماره

    تعداد نسخه‌های درخواستی.

  • دوبلکس

    حالت دوطرفه

    حالت دوطرفه درخواستی.

  • اندازه رسانه

    اندازه رسانه

    اندازه رسانه درخواستی.

روش‌ها

getPrintJobs()

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

لیست کارهای چاپ تکمیل شده را برمی‌گرداند.

پارامترها

بازگشت‌ها

  • قول بده< PrintJobInfo []>

    کروم ۹۶+

    Promiseها فقط برای Manifest V3 و نسخه‌های بعدی پشتیبانی می‌شوند، سایر پلتفرم‌ها باید از callbackها استفاده کنند.

رویدادها

onPrintJobFinished

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

این رویداد زمانی اجرا می‌شود که کار چاپ به پایان رسیده باشد. این شامل هر یک از وضعیت‌های خاتمه: ناموفق، لغو شده و چاپ شده می‌شود.

پارامترها