chrome.printingMetrics

شرح

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

مجوزها

printingMetrics

دسترسی

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

انواع

ColorMode

Enum

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

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

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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

مناسبت ها

onPrintJobFinished

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

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

مولفه های

  • پاسخ به تماس

    تابع

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

    (jobInfo: PrintJobInfo)=>void

،

شرح

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

مجوزها

printingMetrics

دسترسی

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

انواع

ColorMode

Enum

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

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

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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

مناسبت ها

onPrintJobFinished

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

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

مولفه های

  • پاسخ به تماس

    تابع

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

    (jobInfo: PrintJobInfo)=>void