chrome.pageCapture

الوصف

استخدِم واجهة برمجة تطبيقات chrome.pageCapture لحفظ علامة تبويب بتنسيق MHTML.

الأذونات

pageCapture

MHTML هو تنسيق قياسي تدعمه معظم المتصفحات. وهو يغلف صفحة في ملف واحد وجميع موارده (ملفات CSS والصور..).

لاحظ أنه لأسباب أمنية لا يمكن تحميل ملف MHTML إلا من نظام الملفات وأنه يمكن أن يتم تحميله فقط في الإطار الرئيسي.

البيان

يجب تعريف السمة pageCapture. إذن في بيان الإضافة لاستخدام pageCapture واجهة برمجة التطبيقات. على سبيل المثال:

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

الطُرق

saveAsMHTML()

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

يحفظ هذا الإعداد محتوى علامة التبويب بالمعرّف المحدّد بتنسيق MHTML.

المعلمات

  • التفاصيل

    كائن

    • tabId

      الرقم

      رقم تعريف علامة التبويب المراد حفظها بتنسيق MHTML.

  • رد الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (mhtmlData?: ArrayBuffer) => void

    • mhtmlData

      ArrayBuffer اختيارية

      يشير هذا المصطلح إلى بيانات MHTML على أنّها Blob.

المرتجعات

  • Promise<ArrayBuffer | غير محددة>

    الإصدار 116 من Chrome أو الإصدارات الأحدث

    لا تتوفّر الوعود إلا مع إصدار Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.