chrome.mimeHandler

תיאור

משתמשים ב-chrome.mimeHandler API כדי לטפל בזרמים של סוג MIME בתוספים של צד שלישי.

זמינות

בהמתנה

סוגים

MimeHandlerOptions

מאפיינים

• פעיל

  בוליאני

  האם ה-handler הזה פעיל עבור סוג ה-MIME הנתון.

StreamInfo

מאפיינים

• מוטמע

  בוליאני

  הערך הוא True אם הטעינה מתבצעת בהקשר מוטמע (iframe/embed/object).

• mimeType

  מחרוזת

  סוג ה-MIME של התוכן שיירט.

• originalUrl

  מחרוזת

  כתובת ה-URL המקורית שאליה המשתמש עבר.

• responseHeaders

  אובייקט

  כותרות של תגובת HTTP כצמדי מפתח/ערך.

• streamUrl

  מחרוזת

  כתובת ה-URL שממנה יאוחזרו נתוני המקור.

• tabId

  number

  מזהה הכרטיסייה שמכילה את המסמך.

Methods

abortAndFallbackToNativeHandler()

Promise

chrome.mimeHandler.abortAndFallbackToNativeHandler(
  callback?: function,
): Promise<void>

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

פרמטרים

• callback

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

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

  () => void

החזרות

• Promise<void>

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

getMimeHandlerOptions()

Promise

chrome.mimeHandler.getMimeHandlerOptions(
  mimeType: string,
  callback?: function,
): Promise<MimeHandlerOptions>

קריאת האפשרויות שנשמרו עבור סוג MIME. אם לא נשמרו ערכי ברירת מחדל, הפונקציה מחזירה את ערכי ברירת המחדל (enabled=true).

פרמטרים

• mimeType

  מחרוזת

  סוג ה-MIME שאפשרויות הקריאה שלו.

• callback

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

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

  (options: MimeHandlerOptions) => void

  • options

    MimeHandlerOptions

החזרות

• Promise<MimeHandlerOptions>

  ההבטחה נפתרה עם האפשרויות שנשמרו לסוג ה-MIME.

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

getStreamInfo()

Promise

chrome.mimeHandler.getStreamInfo(
  callback?: function,
): Promise<StreamInfo>

אחזור מידע על הזרם בהקשר הנוכחי של הטיפול ב-MIME. הפונקציה חייבת להיקרא מתוך דף תוסף של מטפל MIME.

פרמטרים

• callback

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

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

  (info: StreamInfo) => void

  • מידע

    StreamInfo

החזרות

• Promise<StreamInfo>

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

setMimeHandlerOptions()

Promise

chrome.mimeHandler.setMimeHandlerOptions(
  mimeType: string,
  options: MimeHandlerOptions,
  callback?: function,
): Promise<void>

הגדרת אפשרויות התצורה לסוג MIME ספציפי.

פרמטרים

• mimeType

  מחרוזת

  סוג ה-MIME שרוצים להגדיר.

• options

  MimeHandlerOptions

  האפשרויות החדשות לשימוש.

• callback

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

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

  () => void

החזרות

• Promise<void>

  ההבטחה מתקיימת כשההגדרה נקבעת.

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