chrome.mimeHandler

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

זמינות

‫Chrome 151 ואילך

סוגים

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

החזרות

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

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

getStreamInfo()

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

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

פרמטרים

  • callback

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

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

    (info: StreamInfo) => void

החזרות

  • Promise<StreamInfo>

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

setMimeHandlerOptions()

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

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

פרמטרים

  • mimeType

    מחרוזת

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

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

  • callback

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

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

    () => void

החזרות

  • Promise<void>

    אובייקט promise נפתר כשההגדרה נקבעת.

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