chrome.pageCapture

refresh date: 2026-09-25 robots: noindex

תיאור

משתמשים ב-API של chrome.pageCapture כדי לשמור כרטיסייה כ-MHTML.

הרשאות

pageCapture

‫MHTML הוא פורמט סטנדרטי שנתמך ברוב הדפדפנים. הוא כולל בקובץ אחד דף וכל המשאבים שלו (קובצי CSS, תמונות וכו').

חשוב לשים לב שמטעמי אבטחה, אפשר לטעון קובץ MHTML רק ממערכת הקבצים ורק במסגרת הראשית.

מניפסט

כדי להשתמש ב-API של pageCapture, צריך להצהיר על ההרשאה "pageCapture" במניפסט של התוסף. לדוגמה:

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

Methods

saveAsMHTML()

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

שמירת התוכן של הכרטיסייה עם המזהה שצוין כ-MHTML.

פרמטרים

  • פרטים

    אובייקט

    • tabId

      number

      המזהה של הכרטיסייה שרוצים לשמור כ-MHTML.

  • callback

    function optional

    הפרמטר callback נראה כך: 

    (mhtmlData?: Blob) => void

    • mhtmlData

      כתם אופציונלי

      נתוני ה-MHTML כ-Blob.

החזרות

  • Promise<Blob | undefined>

    ‫Chrome מגרסה 116 ואילך

    ההבטחה מתקיימת כשה-MHTML נוצר.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).