chrome.mimeHandler

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu API chrome.mimeHandler, aby obsługiwać strumienie typów MIME w rozszerzeniach innych firm.

Dostępność

Chrome 151 lub nowsza wersja

Typy

MimeHandlerOptions

Właściwości

• canEmbed

  boolean opcjonalne

  Chrome 157 lub nowsza wersja

  Określa, czy ten moduł obsługi może być używany do wczytywania elementów umieszczonych na stronie (iframe, embed, object). Domyślnie jest to wartość can_embed wpisu w pliku manifestu. Nie ma wpływu, gdy zasada enabled ma wartość Fałsz.

• aktywne

  boolean opcjonalne

  Określa, czy ten moduł obsługi jest włączony. Domyślnie jest to wartość enabled wpisu w pliku manifestu.

StreamInfo

Właściwości

• umieszczone

  wartość logiczna

  Wartość „true”, jeśli odtwarzacz został wczytany w kontekście umieszczonym (iframe/embed/object).

• mimeType

  tekst

  Typ MIME przechwyconych treści.

• originalUrl

  tekst

  Pierwotny adres URL, na który przeszedł użytkownik.

• responseHeaders

  obiekt

  Nagłówki odpowiedzi HTTP jako pary klucz-wartość.

• streamUrl

  tekst

  Adres URL, z którego mają być pobierane dane strumienia.

• tabId

  liczba

  Identyfikator karty zawierającej dokument.

Metody

abortAndFallbackToNativeHandler()

Obietnica

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

Przerywa obsługę bieżącego strumienia i przekazuje treść do natywnego modułu obsługi klienta użytkownika. Po tym wywołaniu ramka rozszerzenia zostanie usunięta. Nie należy oczekiwać dalszego wykonywania.

Parametry

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  () => void

Zwroty

• thought Promise<void>

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getMimeHandlerOptions()

Obietnica

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

Odczytuje opcje typu MIME. Każdy element jest wartością ustawioną przez rozszerzenie lub wartością wpisu w pliku manifestu, jeśli rozszerzenie jej nie ustawiło.

Parametry

• mimeType

  tekst

  Typ MIME, którego opcje mają zostać odczytane. Musi to być typ MIME, który rozszerzenie obsługuje za pomocą mime_types_handler.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (options: MimeHandlerOptions) => void

  • Opcje

    MimeHandlerOptions

Zwroty

• Promise<MimeHandlerOptions>

  Obiekt Promise został rozwiązany z opcjami typu MIME.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getStreamInfo()

Obietnica

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

Pobiera informacje o strumieniu dla bieżącego kontekstu modułu obsługi MIME. Musi być wywoływana ze strony rozszerzenia obsługującego MIME.

Parametry

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (info: StreamInfo) => void

  • informacje

    StreamInfo

Zwroty

• Promise<StreamInfo>

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

setMimeHandlerOptions()

Obietnica

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

Ustawia opcje konfiguracji dla określonego typu MIME. Jeśli rozszerzenie działa w trybie incognito, opcje ustawione w trybie incognito obowiązują tylko w tym trybie i do momentu zakończenia sesji incognito. Opcje, które nie zostały ustawione w trybie incognito, będą miały wartości ustawione poza tym trybem.

Parametry

• mimeType

  tekst

  Typ MIME do skonfigurowania. Musi to być typ MIME, który rozszerzenie obsługuje za pomocą mime_types_handler.

• Opcje

  MimeHandlerOptions

  Opcje do zmiany.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  () => void

Zwroty

• thought Promise<void>

  Obietnica spełniona po ustawieniu konfiguracji.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.