chrome.mimeHandler

Opis

Użyj interfejsu chrome.mimeHandler API do obsługi strumieni typu MIME w rozszerzeniach innych firm.

Dostępność

Chrome 151 lub nowsza

Typy

MimeHandlerOptions

Właściwości

  • włączone

    Wartość logiczna

    Określa, czy ten moduł obsługi jest aktywny w przypadku danego typu MIME.

StreamInfo

Właściwości

  • umieszczone

    Wartość logiczna

    Wartość „Prawda”, jeśli element jest wczytany w kontekście umieszczonym (iframe/embed/object).

  • mimeType

    ciąg znaków

    Typ MIME przechwyconych treści.

  • originalUrl

    ciąg znaków

    Pierwotny adres URL, do którego użytkownik przeszedł.

  • responseHeaders

    obiekt

    Nagłówki odpowiedzi HTTP w postaci par klucz-wartość.

  • streamUrl

    ciąg znaków

    Adres URL, z którego mają zostać pobrane dane strumienia.

  • tabId

    liczba

    Identyfikator karty zawierającej dokument.

Metody

abortAndFallbackToNativeHandler()

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

Przerywa bieżącą obsługę strumienia i przekazuje treść do natywnego modułu obsługi agenta użytkownika. Po tym wywołaniu ramka rozszerzenia zostanie zamknięta. Wywołujący nie powinni oczekiwać dalszego wykonania.

Parametry

  • callback

    function opcjonalny

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getMimeHandlerOptions()

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

Odczytuje zapisane opcje dla typu MIME. Jeśli nie ma zapisanych ustawień, zwraca wartości domyślne (enabled=true).

Parametry

  • mimeType

    ciąg znaków

    Typ MIME, którego opcje mają być odczytane.

  • callback

    function opcjonalny

    Parametr callback wygląda tak:

    (options: MimeHandlerOptions) => void

Zwroty

  • Obietnica rozwiązana z utrwalonymi opcjami typu MIME.

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getStreamInfo()

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

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

Parametry

  • callback

    function opcjonalny

    Parametr callback wygląda tak:

    (info: StreamInfo) => void

Zwroty

  • Promise<StreamInfo>

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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.

Parametry

  • mimeType

    ciąg znaków

    Typ MIME do skonfigurowania.

  • Nowe opcje do wykorzystania.

  • callback

    function opcjonalny

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Obietnica spełniona po ustawieniu konfiguracji.

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.