chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.mimeHandler API om MIME-typestreams te verwerken in extensies van derden.

Beschikbaarheid

Chrome 151+

Typen

MimeHandlerOptions

Eigenschappen

  • canEmbed

    booleaans optioneel

    Chrome 157+

    Of deze handler mag worden gebruikt voor ingesloten ladingen (iframe, embed, object). De standaardwaarde is de waarde can_embed van de manifest-vermelding. Heeft geen effect als enabled onwaar is.

  • aangezet

    booleaans optioneel

    Of deze handler aanstaat. De standaardwaarde is de waarde enabled van de manifest-vermelding.

StreamInfo

Eigenschappen

  • ingesloten

    booleaans

    Waar als de content is geladen in een ingesloten context (iframe/embed/object).

  • mimeType

    tekenreeks

    Het MIME-type van de onderschepte content.

  • originalUrl

    tekenreeks

    De oorspronkelijke URL waarnaar de gebruiker is genavigeerd.

  • responseHeaders

    object

    HTTP-reactieheaders als sleutel/waarde-paren.

  • streamUrl

    tekenreeks

    De URL waar de streamgegevens vandaan moeten worden opgehaald.

  • tabId

    getal

    De tabblad-ID met het document.

Methoden

abortAndFallbackToNativeHandler()

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

Breekt de huidige streamverwerking af en geeft de content door aan de systeemeigen handler van de user-agent. Na deze aanroep wordt het extensieframe afgebroken. Bellers moeten geen verdere uitvoering verwachten.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getMimeHandlerOptions()

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

Leest de opties voor een MIME-type. Elk lid is de waarde die de extensie heeft ingesteld of de waarde van de manifestvermelding als de extensie deze niet heeft ingesteld.

Parameters

  • mimeType

    tekenreeks

    Het MIME-type waarvan de opties moeten worden gelezen. Het moet een MIME-type zijn dat de extensie verwerkt via mime_types_handler.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (options: MimeHandlerOptions) => void

Retourzendingen

  • Promise opgelost met de opties voor het MIME-type.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getStreamInfo()

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

Haalt streaminformatie op voor de huidige MIME-handlercontext. Moet worden aangeroepen vanuit een pagina van de MIME-handlerextensie.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (info: StreamInfo) => void

Retourzendingen

  • Promise<StreamInfo>

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setMimeHandlerOptions()

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

Stelt de configuratieopties in voor een opgegeven MIME-type. Als de extensie wordt uitgevoerd in de gesplitste incognitomodus, zijn de opties die zijn ingesteld vanuit de incognitomodus alleen van toepassing op de incognitomodus en duren ze tot de incognitosessie is beëindigd. Opties die niet zijn ingesteld vanuit de incognitomodus, volgen de waarden die buiten de incognitomodus zijn ingesteld.

Parameters

  • mimeType

    tekenreeks

    Het MIME-type dat je wilt instellen. Het moet een MIME-type zijn dat de extensie verwerkt via mime_types_handler.

  • De opties die je kunt wijzigen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Promise opgelost als de configuratie is ingesteld.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.