chrome.pageCapture

الوصف

استخدِم chrome.pageCapture API لحفظ علامة تبويب بتنسيق 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.

المرتجعات

• الوعد<ArrayBuffer|غير محدّد>

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

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