chrome.pageCapture

شرح

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

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

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

مجوزها

pageCapture

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

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

مواد و روش ها

saveAsMHTML()

وعده
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
)

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

مولفه های

  • جزئیات

    هدف - شی

    • tabId

      عدد

      شناسه برگه برای ذخیره به عنوان MHTML.

  • پاسخ به تماس

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

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

    (mhtmlData?: ArrayBuffer)=>void

    • mhtmlداده

      ArrayBuffer اختیاری است

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

برمی گرداند

  • Promise<ArrayBuffer|undefined>

    Chrome 116+

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