chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Description

Utilisez l'API chrome.mimeHandler pour gérer les flux de types MIME dans les extensions tierces.

Disponibilité

Chrome 151 ou version ultérieure

Types

MimeHandlerOptions

Propriétés

  • canEmbed

    boolean facultatif

    Chrome 157 ou version ultérieure

    Indique si ce gestionnaire peut être utilisé pour les chargements intégrés (iframe, embed, object). La valeur par défaut est la valeur can_embed de l'entrée du fichier manifeste. N'a aucun effet lorsque enabled est défini sur "false".

  • activé

    boolean facultatif

    Indique si ce gestionnaire est activé. La valeur par défaut est la valeur enabled de l'entrée du fichier manifeste.

StreamInfo

Propriétés

  • intégré

    booléen

    "True" si le chargement est effectué dans un contexte intégré (iframe/embed/object).

  • mimeType

    chaîne

    Type MIME du contenu intercepté.

  • originalUrl

    chaîne

    URL d'origine vers laquelle l'utilisateur a été redirigé.

  • responseHeaders

    objet

    En-têtes de réponse HTTP sous forme de paires clé/valeur.

  • streamUrl

    chaîne

    URL à partir de laquelle récupérer les données du flux.

  • tabId

    nombre

    ID de l'onglet contenant le document.

Méthodes

abortAndFallbackToNativeHandler()

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

Annule le traitement du flux actuel et transmet le contenu au gestionnaire natif de l'user-agent. Après cet appel, le frame d'extension sera supprimé. Les appelants ne doivent pas s'attendre à une exécution ultérieure.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getMimeHandlerOptions()

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

Lit les options d'un type MIME. Chaque membre correspond à la valeur définie par l'extension ou à la valeur de l'entrée du fichier manifeste si l'extension ne l'a pas définie.

Paramètres

  • mimeType

    chaîne

    Type MIME dont les options doivent être lues. Il doit s'agir d'un type MIME que l'extension gère via mime_types_handler.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (options: MimeHandlerOptions) => void

Renvoie

  • Promesse résolue avec les options du type MIME.

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getStreamInfo()

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

Récupère les informations de flux pour le contexte du gestionnaire MIME actuel. Doit être appelée à partir d'une page d'extension de gestionnaire MIME.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (info: StreamInfo) => void

Renvoie

  • Promise<StreamInfo>

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

setMimeHandlerOptions()

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

Définit les options de configuration pour un type MIME spécifié. Si l'extension s'exécute en mode navigation privée fractionné, les options définies en mode navigation privée ne s'appliquent qu'en mode navigation privée et durent jusqu'à la fin de la session de navigation privée. Les options qui ne sont pas définies en mode navigation privée suivent les valeurs définies en dehors de ce mode.

Paramètres

  • mimeType

    chaîne

    Type MIME à configurer. Il doit s'agir d'un type MIME que l'extension gère via mime_types_handler.

  • Options à modifier.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Promesse résolue lorsque la configuration a été définie.

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.