chrome.pageCapture

תיאור

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

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

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

הרשאות

pageCapture

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

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

שיטות

saveAsMHTML()

הבטחה 
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
)

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

פרמטרים

  • פרטים

    אובייקט

    • tabId

      מספר

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

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

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

    (mhtmlData?: ArrayBuffer)=>void

    • mhtmlData

      ArrayBuffer אופציונלי

      נתוני MHTML ככחול.

החזרות

  • Promise<ArrayBuffer|undefined>

    Chrome 116 ומעלה

    יש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.