chrome.printingMetrics

refresh date: 2026-09-25 robots: noindex

شرح

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

اجازه‌ها

printingMetrics

دردسترس بودن

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 «رسانه» هستند و می‌توان آن‌ها را در صفحه IANA پیدا کرد.

  • عرض

    شماره

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

Printer

مشخصات

  • نام

    رشته

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

  • منبع

    PrinterSource

    منبع چاپگر.

  • uri

    رشته

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

PrinterSource

منبع چاپگر.

شمارشی

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

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

PrintJobInfo

مشخصات

  • completionTime

    شماره

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

  • creationTime

    شماره

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

  • id

    رشته

    شناسه کار.

  • numberOfPages

    شماره

    تعداد صفحه‌های سند.

  • چاپگر

    چاپگر

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

  • printer_status

    PrinterStatus

    Chrome نسخه ۸۵ و بالاتر

    وضعیت چاپگر.

  • تنظیمات

    PrintSettings

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

  • منبع

    PrintJobSource

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

  • sourceId

    رشته اختیاری

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

  • وضعیت

    PrintJobStatus

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

  • عنوان

    رشته

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

PrintJobSource

منبع کار چاپ.

شمارشی

"PRINT_PREVIEW"
مشخص می‌کند که کار از صفحه «پیش‌نمای چاپ» که کاربر شروع کرده ایجاد شده است.

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

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

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

PrintJobStatus

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

شمارشی

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

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

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

PrintSettings

مشخصات

  • رنگ

    ColorMode

    حالت رنگ درخواست‌شده.

  • کپی‌ها

    شماره

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

  • دوطرفه

    DuplexMode

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

  • mediaSize

    MediaSize

    اندازه رسانه درخواست‌شده.

روش‌ها

getPrintJobs()

قول 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

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

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (jobs: PrintJobInfo[]) => void

بازگشتی‌ها

  • Promise<PrintJobInfo[]>

    Chrome نسخه ۹۶ به بالا

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

رویدادها

onPrintJobFinished

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

رویداد زمانی فعال می‌شود که کار چاپ تمام شده باشد. این شامل هریک از وضعیت‌های پایان‌یافته می‌شود: FAILED (ناموفق)، CANCELED (لغوشده)، و PRINTED (چاپ‌شده).

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (jobInfo: PrintJobInfo) => void