chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API chrome.mimeHandler per gestire gli stream di tipi MIME nelle estensioni di terze parti.

Disponibilità

Chrome 151 e versioni successive

Tipi

MimeHandlerOptions

Proprietà

  • canEmbed

    boolean facoltativo

    Chrome 157+

    Indica se questo gestore può essere utilizzato per i caricamenti incorporati (iframe, embed, object). Il valore predefinito è il valore can_embed della voce del manifest. Non ha alcun effetto se enabled è impostato su false.

  • attivato

    boolean facoltativo

    Indica se questo gestore è abilitato. Il valore predefinito è il valore enabled della voce del manifest.

StreamInfo

Proprietà

  • incorporato

    booleano

    True se caricato in un contesto incorporato (iframe/embed/object).

  • mimeType

    stringa

    Il tipo MIME dei contenuti intercettati.

  • originalUrl

    stringa

    L'URL di origine a cui l'utente ha eseguito la navigazione.

  • responseHeaders

    oggetto

    Intestazioni della risposta HTTP come coppie chiave-valore.

  • streamUrl

    stringa

    L'URL da cui recuperare i dati dello stream.

  • tabId

    numero

    L'ID della scheda contenente il documento.

Metodi

abortAndFallbackToNativeHandler()

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

Interrompe la gestione dello stream corrente e trasferisce i contenuti al gestore nativo dello user agent. Dopo questa chiamata, il frame dell'estensione verrà rimosso; i chiamanti non devono aspettarsi un'ulteriore esecuzione.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getMimeHandlerOptions()

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

Legge le opzioni per un tipo MIME. Ogni membro è il valore impostato dall'estensione o il valore della voce del manifest se l'estensione non lo ha impostato.

Parametri

  • mimeType

    stringa

    Il tipo MIME di cui leggere le opzioni. Deve essere un tipo MIME gestito dall'estensione tramite mime_types_handler.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (options: MimeHandlerOptions) => void

Resi

  • Promise risolta con le opzioni per il tipo MIME.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getStreamInfo()

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

Recupera le informazioni sullo stream per il contesto del gestore MIME corrente. Deve essere chiamata da una pagina di estensione del gestore MIME.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (info: StreamInfo) => void

Resi

  • Promise<StreamInfo>

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

setMimeHandlerOptions()

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

Imposta le opzioni di configurazione per un tipo MIME specificato. Se l'estensione viene eseguita in modalità Incognito divisa, le opzioni impostate in incognito si applicano solo in incognito e durano fino al termine della sessione in incognito. Le opzioni non impostate in incognito seguono i valori impostati al di fuori della modalità di navigazione in incognito.

Parametri

  • mimeType

    stringa

    Il tipo MIME da configurare. Deve essere un tipo MIME gestito dall'estensione tramite mime_types_handler.

  • Le opzioni da modificare.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Promessa risolta quando la configurazione è stata impostata.

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.