chrome.pageCapture

refresh date: 2026-09-25 robots: noindex

شرح

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

اجازه‌ها

pageCapture

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

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

مانیفست

برای استفاده از میانای برنامه‌سازی کاربردی pageCapture، باید اجازه «pageCapture» را در مانیفست افزونه اعلام کنید. برای مثال:

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

روش‌ها

saveAsMHTML()

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

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

پارامترها

  • جزئیات

    شیء

    • tabId

      شماره

      شناسه زبانه‌ای که باید به‌عنوان MHTML ذخیره شود.

  • تماس برگشتی

    تابع اختیاری

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

    (mhtmlData?: Blob) => void

    • mhtmlData

      حباب اختیاری

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

بازگشتی‌ها

  • Promise<Blob | undefined>

    Chrome نسخه ۱۱۶ و بالاتر

    وقتی MHTML تولید شد، حل‌وفصل می‌شود.

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