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

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

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

    (mhtmlData?: Blob) => void

    • mhtmlData

      Blob اختياري

      بيانات MHTML ككائن ثنائي كبير (Blob)

المرتجعات

  • Promise<Blob | undefined>

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

    يتم حلّ المشكلة عند إنشاء ملف MHTML.

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