chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Descripción

Usa la API de chrome.mimeHandler para controlar los flujos de tipos de MIME en extensiones de terceros.

Disponibilidad

Chrome 151 y versiones posteriores

Tipos

MimeHandlerOptions

Propiedades

  • canEmbed

    booleano opcional

    Chrome 157 o versiones posteriores

    Indica si este controlador se puede usar para cargas incorporadas (iframe, embed, object). El valor predeterminado es el valor can_embed de la entrada del manifiesto. No tiene ningún efecto mientras enabled sea falso.

  • habilitado

    booleano opcional

    Indica si este controlador está habilitado. El valor predeterminado es el valor enabled de la entrada del manifiesto.

StreamInfo

Propiedades

  • incorporado

    booleano

    Es verdadero si se carga en un contexto incorporado (iframe/embed/object).

  • mimeType

    string

    Es el tipo de MIME del contenido interceptado.

  • originalUrl

    string

    Es la URL original a la que navegó el usuario.

  • responseHeaders

    objeto

    Son los encabezados de respuesta HTTP como pares clave-valor.

  • streamUrl

    string

    Es la URL desde la que se recuperarán los datos de transmisión.

  • tabId

    número

    Es el ID de la pestaña que contiene el documento.

Métodos

abortAndFallbackToNativeHandler()

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

Anula el control de la transmisión actual y entrega el contenido al controlador nativo del usuario-agente. Después de esta llamada, se cerrará el marco de la extensión; los emisores no deben esperar más ejecuciones.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getMimeHandlerOptions()

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

Lee las opciones de un tipo de MIME. Cada miembro es el valor que estableció la extensión o el valor de la entrada del manifiesto si la extensión no lo estableció.

Parámetros

  • mimeType

    string

    Es el tipo de MIME cuyas opciones se leerán. Debe ser un tipo de MIME que la extensión controle a través de mime_types_handler.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (options: MimeHandlerOptions) => void

Muestra

  • Es la promesa que se resuelve con las opciones para el tipo de MIME.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getStreamInfo()

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

Recupera información de la transmisión para el contexto actual del controlador de MIME. Se debe llamar desde una página de extensión del controlador de MIME.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (info: StreamInfo) => void

Muestra

  • Promise<StreamInfo>

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

setMimeHandlerOptions()

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

Establece las opciones de configuración para un tipo de MIME especificado. Si la extensión se ejecuta en el modo Incógnito dividido, las opciones que se establezcan desde el modo Incógnito solo se aplicarán a este modo y durarán hasta que finalice la sesión en modo Incógnito. Las opciones que no se configuran en el modo Incógnito siguen los valores establecidos fuera de este modo.

Parámetros

  • mimeType

    string

    Es el tipo de MIME que se configurará. Debe ser un tipo de MIME que la extensión controle a través de mime_types_handler.

  • Son las opciones que se cambiarán.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    La promesa se resuelve cuando se establece la configuración.

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.