chrome.pageCapture

תיאור

משתמשים ב-chrome.pageCapture API כדי לשמור כרטיסייה כ-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

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

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

    (mhtmlData?: Blob) => void

    • mhtmlData

      ‫Blob אופציונלי

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

החזרות

  • Promise<Blob | undefined>

    ‫Chrome 116 ואילך

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

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.