chrome.pageCapture

توضیحات

از API chrome.pageCapture برای ذخیره یک تب به عنوان MHTML استفاده کنید.

مجوزها

pageCapture

این مجوز باعث ایجاد هشدار می‌شود .

MHTML یک فرمت استاندارد است که توسط اکثر مرورگرها پشتیبانی می‌شود. این فرمت، یک صفحه و تمام منابع آن (فایل‌های CSS، تصاویر و..) را در یک فایل واحد کپسوله می‌کند.

توجه داشته باشید که به دلایل امنیتی، یک فایل MHTML فقط می‌تواند از سیستم فایل و در فریم اصلی بارگذاری شود.

مانیفست

برای استفاده از pageCapture API باید مجوز "pageCapture" را در مانیفست افزونه اعلام کنید. برای مثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "pageCapture"
  ],
  ...
}

روش‌ها

saveAsMHTML()

وعده

chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
): Promise<Blob | undefined>

محتوای تب با شناسه‌ی داده شده را به صورت MHTML ذخیره می‌کند.

پارامترها

• جزئیات

  شیء

  • شناسه برگه

    شماره

    شناسه‌ی برگه‌ای که قرار است به صورت MHTML ذخیره شود.

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به شکل زیر است:

  (mhtmlData?: Blob) => void

  • داده‌های mhtml

    لکه اختیاری

    داده‌های MHTML به عنوان یک Blob.

بازگشت‌ها

• قول <Blob | undefined>

  کروم ۱۱۶+

  وقتی MHTML تولید شد، برطرف می‌شود.

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