chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Beschreibung

Verwenden Sie die chrome.mimeHandler API, um MIME-Typ-Streams in Drittanbietererweiterungen zu verarbeiten.

Verfügbarkeit

Chrome 151 oder höher

Typen

MimeHandlerOptions

Attribute

  • canEmbed

    Boolesch optional

    Chrome 157 oder höher

    Gibt an, ob dieser Handler für eingebettete Ladevorgänge (iframe, embed, object) verwendet werden darf. Der Standardwert ist der can_embed-Wert des Manifesteintrags. Hat keine Auswirkungen, wenn enabled auf „false“ gesetzt ist.

  • aktiviert

    Boolesch optional

    Gibt an, ob dieser Handler aktiviert ist. Der Standardwert ist der enabled-Wert des Manifesteintrags.

StreamInfo

Attribute

  • eingebettet

    boolean

    „True“, wenn in einem eingebetteten Kontext (iframe/embed/object) geladen.

  • mimeType

    String

    Der MIME-Typ des abgefangenen Inhalts.

  • originalUrl

    String

    Die ursprüngliche URL, die der Nutzer aufgerufen hat.

  • responseHeaders

    Objekt

    HTTP-Antwortheader als Schlüssel/Wert-Paare.

  • streamUrl

    String

    Die URL, von der die Streamdaten abgerufen werden sollen.

  • tabId

    Zahl

    Die ID des Tabs, der das Dokument enthält.

Methoden

abortAndFallbackToNativeHandler()

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

Bricht die aktuelle Streamverarbeitung ab und übergibt den Inhalt an den nativen Handler des User-Agents. Nach diesem Aufruf wird der Erweiterungs-Frame abgebaut. Aufrufer sollten keine weitere Ausführung erwarten.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getMimeHandlerOptions()

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

Liest die Optionen für einen MIME-Typ. Jedes Mitglied ist der von der Erweiterung festgelegte Wert oder der Wert des Manifesteintrags, wenn die Erweiterung ihn nicht festgelegt hat.

Parameter

  • mimeType

    String

    Der MIME-Typ, dessen Optionen gelesen werden sollen. Es muss sich um einen MIME-Typ handeln, den die Erweiterung über „mime_types_handler“ verarbeitet.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (options: MimeHandlerOptions) => void

Ausgabe

  • Promise mit den Optionen für den MIME-Typ aufgelöst.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getStreamInfo()

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

Ruft Streaminformationen für den aktuellen MIME-Handler-Kontext ab. Muss von einer MIME-Handler-Erweiterungsseite aus aufgerufen werden.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (info: StreamInfo) => void

Ausgabe

  • Promise<StreamInfo>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setMimeHandlerOptions()

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

Legt die Konfigurationsoptionen für einen angegebenen MIME-Typ fest. Wenn die Erweiterung im geteilten Inkognitomodus ausgeführt wird, gelten die im Inkognitomodus festgelegten Optionen nur für den Inkognitomodus und nur bis zum Ende der Inkognitositzung. Optionen, die nicht im Inkognitomodus festgelegt wurden, folgen den Werten, die außerhalb des Inkognitomodus festgelegt wurden.

Parameter

  • mimeType

    String

    Der zu konfigurierende MIME-Typ. Es muss sich um einen MIME-Typ handeln, den die Erweiterung über „mime_types_handler“ verarbeitet.

  • Die zu ändernden Optionen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Promise, das aufgelöst wird, wenn die Konfiguration festgelegt wurde.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.