chrome.printingMetrics

توضیحات

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

مجوزها

printingMetrics

در دسترس بودن

Chrome 79+ ChromeOS فقط به خط مشی نیاز دارد

انواع

ColorMode

Enum

"BLACK_AND_WHITE"
مشخص می کند که از حالت سیاه و سفید استفاده شده است.

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

DuplexMode

Enum

"ONE_SIDED"
مشخص می کند که از چاپ یک طرفه استفاده شده است.

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

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

MediaSize

خواص

  • ارتفاع

    شماره

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

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

    رشته

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

  • عرض

    شماره

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

Printer

خواص

  • نام

    رشته

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

  • منبع چاپگر

  • اوری

    رشته

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

PrinterSource

منبع چاپگر

Enum

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

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

PrintJobInfo

خواص

  • زمان اتمام

    شماره

    زمان تکمیل کار (در میلی ثانیه گذشته از دوره یونیکس).

  • زمان خلقت

    شماره

    زمان ایجاد شغل (در میلی ثانیه گذشته از دوران یونیکس).

  • شناسه

    رشته

    شناسه شغل

  • تعداد صفحات

    شماره

    تعداد صفحات سند

  • چاپگر

    چاپگر

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

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

    وضعیت چاپگر

    Chrome 85+

    وضعیت چاپگر

  • تنظیمات

    تنظیمات چاپ

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

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

  • شناسه منبع

    رشته اختیاری

    شناسه منبع اگر منبع PRINT_PREVIEW یا ANDROID_APP باشد، پوچ است.

  • وضعیت

    PrintJobStatus

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

  • عنوان

    رشته

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

PrintJobSource

منبع کار چاپ

Enum

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

"ANDROID_APP"
مشخص می کند که کار از یک برنامه Android ایجاد شده است.

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

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

PrintJobStatus

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

Enum

"شکست خورده"
مشخص می کند که کار چاپ به دلیل برخی خطاها قطع شده است.

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

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

PrintSettings

خواص

  • رنگ

    ColorMode

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

  • کپی ها

    شماره

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

  • دوبلکس

    DuplexMode

    حالت دوبلکس درخواستی

  • mediaSize

    MediaSize

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

روش ها

getPrintJobs()

قول بده
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

پارامترها

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (jobs: PrintJobInfo[]) => void

برمی گرداند

  • Promise< PrintJobInfo []>

    Chrome 96+

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

رویدادها

onPrintJobFinished

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

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

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (jobInfo: PrintJobInfo) => void