chrome.pageCapture

الوصف

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

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

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

الأذونات

pageCapture

يجب تعريف السمة 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 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.