chrome.mimeHandler

说明

使用 chrome.mimeHandler API 处理第三方扩展程序中的 MIME 类型流。

可用性

待处理

类型

MimeHandlerOptions

属性

  • 已启用

    布尔值

    相应处理程序是否针对指定 MIME 类型处于有效状态。

StreamInfo

属性

  • 嵌入式播放器

    布尔值

    如果加载到嵌入式上下文（iframe/embed/object）中，则为 true。

  • mimeType

    字符串

    拦截的内容的 MIME 类型。

  • originalUrl

    字符串

    用户最初访问的网址。

  • responseHeaders

    对象

    HTTP 响应标头（以键值对的形式）。

  • streamUrl

    字符串

    用于提取流数据的网址。

  • tabId

    数值

    包含相应文档的标签页 ID。

方法

abortAndFallbackToNativeHandler()

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

中止当前流处理，并将内容交给用户代理的本地处理程序。在此调用之后，扩展框架将被拆除；调用者不应期望进一步执行。

参数

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getMimeHandlerOptions()

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

读取 MIME 类型的持久化选项。如果未存储任何值，则返回默认值 (enabled=true)。

参数

  • mimeType

    字符串

    要读取的 MIME 类型（包含选项）。

  • callback

    函数 可选

    callback 参数如下所示： 

    (options: MimeHandlerOptions) => void

返回

  • 通过 MIME 类型的持久化选项解析的 Promise。

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getStreamInfo()

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

检索当前 MIME 处理程序上下文的数据流信息。必须从 MIME 处理程序扩展程序页面内调用。

参数

  • callback

    函数 可选

    callback 参数如下所示： 

    (info: StreamInfo) => void

返回

  • Promise<StreamInfo>

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

setMimeHandlerOptions()

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

为指定 MIME 类型设置配置选项。

参数

  • mimeType

    字符串

    要配置的 MIME 类型。

  • 要使用的新选项。

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    配置设置完毕后，Promise 即会解析。

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。