chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

תיאור

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

זמינות

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

סוגים

MimeHandlerOptions

מאפיינים

  • canEmbed

    בוליאני אופציונלי

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

    האם אפשר להשתמש ב-handler הזה לטעינות מוטמעות (iframe, ‏ embed, ‏ object). ברירת המחדל היא הערך של can_embed ברשומת המניפסט. אין השפעה כשהערך של enabled הוא False.

  • פעיל

    בוליאני אופציונלי

    אם ה-handler הזה מופעל. ברירת המחדל היא הערך של enabled ברשומת המניפסט.

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>

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

פרמטרים

  • callback

    function optional

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

    () => void

החזרות

  • Promise<void>

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

getMimeHandlerOptions()

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

קורא את האפשרויות של סוג MIME. כל איבר הוא הערך שהתוסף הגדיר, או הערך של הרשומה במניפסט אם התוסף לא הגדיר אותו.

פרמטרים

  • mimeType

    מחרוזת

    סוג ה-MIME שהאפשרויות שלו ייקראו. הוא חייב להיות סוג MIME שהתוסף מטפל בו באמצעות mime_types_handler.

  • callback

    function optional

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

    (options: MimeHandlerOptions) => void

החזרות

  • ה-Promise נפתר עם האפשרויות של סוג ה-MIME.

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

getStreamInfo()

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

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

פרמטרים

  • callback

    function optional

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

    (info: StreamInfo) => void

החזרות

  • Promise<StreamInfo>

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

setMimeHandlerOptions()

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

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

פרמטרים

  • mimeType

    מחרוזת

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

  • אפשרויות

    MimeHandlerOptions

    האפשרויות לשינוי.

  • callback

    function optional

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

    () => void

החזרות

  • Promise<void>

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

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