chrome.mimeHandler

Описание

Используйте API chrome.mimeHandler для обработки потоков MIME-типов в сторонних расширениях.

Доступность

В ожидании

Типы

MimeHandlerOptions

Характеристики

  • включено

    логический

    Указывает, активен ли данный обработчик для заданного типа MIME.

StreamInfo

Характеристики

  • встроенный

    логический

    Возвращает true, если загружается во встроенном контексте (iframe/embed/object).

  • mimeType

    нить

    MIME-тип перехваченного контента.

  • originalUrl

    нить

    Исходный URL-адрес, на который перешёл пользователь.

  • responseHeaders

    объект

    Заголовки HTTP-ответа представлены в виде пар ключ-значение.

  • streamUrl

    нить

    URL-адрес, с которого следует получать данные потока.

  • tabId

    число

    Идентификатор вкладки, содержащей документ.

Методы

abortAndFallbackToNativeHandler()

Обещать
chrome.mimeHandler.abortAndFallbackToNativeHandler(
  callback?: function,
): Promise<void>

Прерывает текущую обработку потока и передает контент собственному обработчику пользовательского агента. После этого вызова расширенный кадр будет закрыт; вызывающие стороны не должны ожидать дальнейшего выполнения.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getMimeHandlerOptions()

Обещать
chrome.mimeHandler.getMimeHandlerOptions(
  mimeType: string,
  callback?: function,
): Promise<MimeHandlerOptions>

Считывает сохраненные параметры для типа MIME. Возвращает значения по умолчанию (enabled=true), если таковые не были сохранены.

Параметры

  • mimeType

    нить

    MIME-тип, параметры которого необходимо прочитать.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (options: MimeHandlerOptions) => void

Возвраты

  • Promise< MimeHandlerOptions >

    Обещание выполнено с сохранением параметров для MIME-типа.

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getStreamInfo()

Обещать
chrome.mimeHandler.getStreamInfo(
  callback?: function,
): Promise<StreamInfo>

Получает информацию о потоке для текущего контекста обработчика MIME. Должен вызываться из страницы расширения обработчика MIME.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (info: StreamInfo) => void

Возвраты

  • Promise< StreamInfo >

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

setMimeHandlerOptions()

Обещать
chrome.mimeHandler.setMimeHandlerOptions(
  mimeType: string,
  options: MimeHandlerOptions,
  callback?: function,
): Promise<void>

Задает параметры конфигурации для указанного типа MIME.

Параметры

  • mimeType

    нить

    Тип MIME для настройки.

  • параметры

    MimeHandlerOptions

    Новые доступные варианты использования.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Обещание выполняется после установки конфигурации.

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.