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

  • habilitado

    booleano

    Indica si este controlador está activo para el tipo de MIME determinado.

StreamInfo

Propiedades

  • Incorporado

    booleano

    Es verdadero si se carga en un contexto incorporado (iframe/incorporación/objeto).

  • mimeType

    string

    Es el tipo de MIME del contenido interceptado.

  • originalUrl

    string

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

  • responseHeaders

    objeto

    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

    ID de la pestaña que contiene el documento.

Métodos

abortAndFallbackToNativeHandler()

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

Anula el control de transmisión actual y entrega el contenido al controlador nativo del agente de usuario. Después de esta llamada, se cerrará el marco de la extensión, por lo que los llamadores 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 persistentes para un tipo de MIME. Devuelve los valores predeterminados (enabled=true) si no se almacenó ninguno.

Parámetros

  • mimeType

    string

    Es el tipo de MIME cuyas opciones se leerán.

  • 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 persistentes 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 la información de transmisión para el contexto actual del controlador de MIME. Se debe llamar desde una página de extensión del controlador 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.

Parámetros

  • mimeType

    string

    Es el tipo de MIME que se configurará.

  • Son las nuevas opciones que se pueden usar.

  • callback

    función opcional

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

    () => void

Muestra

  • Promise<void>

    Promesa que 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.