chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.mimeHandler para processar streams de tipo MIME em extensões de terceiros.

Disponibilidade

Chrome 151+

Tipos

MimeHandlerOptions

Propriedades

  • canEmbed

    booleano opcional

    Chrome 157 ou mais recente

    Se esse gerenciador pode ser usado para carregamentos incorporados (iframe, embed, object). O padrão é o valor can_embed da entrada do manifesto. Não tem efeito enquanto enabled é falso.

  • ativado

    booleano opcional

    Indica se esse gerenciador está ativado. O padrão é o valor enabled da entrada do manifesto.

StreamInfo

Propriedades

  • incorporado

    booleano

    Verdadeiro se carregado em um contexto incorporado (iframe/embed/object).

  • mimeType

    string

    O tipo MIME do conteúdo interceptado.

  • originalUrl

    string

    O URL de origem que o usuário acessou.

  • responseHeaders

    objeto

    Cabeçalhos de resposta HTTP como pares de chave-valor.

  • streamUrl

    string

    O URL para buscar os dados do stream.

  • tabId

    número

    O ID da guia que contém o documento.

Métodos

abortAndFallbackToNativeHandler()

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

Cancela o processamento do stream atual e entrega o conteúdo ao gerenciador nativo do user agent. Depois dessa chamada, o frame da extensão será desativado. Os autores da chamada não devem esperar mais execuções.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getMimeHandlerOptions()

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

Lê as opções de um tipo MIME. Cada membro é o valor definido pela extensão ou o valor da entrada do manifesto, se a extensão não o tiver definido.

Parâmetros

  • mimeType

    string

    O tipo MIME com as opções a serem lidas. Precisa ser um tipo MIME que a extensão processa usando mime_types_handler.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (options: MimeHandlerOptions) => void

Retorna

  • Promessa resolvida com as opções para o tipo MIME.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getStreamInfo()

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

Recupera informações de stream para o contexto atual do gerenciador de MIME. Precisa ser chamado em uma página de extensão do gerenciador de MIME.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (info: StreamInfo) => void

Retorna

  • Promise<StreamInfo>

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

setMimeHandlerOptions()

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

Define as opções de configuração para um tipo MIME especificado. Se a extensão for executada no modo de navegação anônima dividido, as opções definidas na navegação anônima serão aplicadas apenas a ela e vão durar até o fim da sessão de navegação anônima. As opções não definidas na navegação anônima seguem os valores definidos fora dela.

Parâmetros

  • mimeType

    string

    O tipo MIME a ser configurado. Precisa ser um tipo MIME que a extensão processa usando mime_types_handler.

  • As opções para mudar.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Promessa resolvida quando a configuração é definida.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.