chrome.pageCapture

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

pageCapture

‫MHTML هو تنسيق عادي متوافق مع معظم المتصفّحات. وهو يجمع في ملف واحد صفحة وجميع مواردها (ملفات CSS والصور وما إلى ذلك).

يُرجى العِلم أنّه لأسباب تتعلّق بالأمان، لا يمكن تحميل ملف MHTML إلا من نظام الملفات، ولا يمكن تحميله إلا في الإطار الرئيسي.

البيان

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

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

الطُرق

saveAsMHTML()

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

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

المعلمات

  • التفاصيل

    عنصر

    • tabId

      الرقم

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

  • callback

    function اختياري

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

    (mhtmlData?: Blob) => void

    • mhtmlData

      Blob اختياري

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

المرتجعات

  • Promise<Blob | undefined>

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

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

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