refresh date: 2026-09-25 robots: noindex
说明
使用 chrome.mimeHandler API 处理第三方扩展程序中的 MIME 类型流。
可用性
类型
MimeHandlerOptions
属性
-
canEmbed
布尔值 （可选）
Chrome 157 及更高版本此处理程序是否可用于嵌入式加载（iframe、embed、object）。默认值为清单条目的
can_embed值。当enabled为 false 时，此属性没有任何影响。 -
已启用
布尔值 （可选）
此处理程序是否已启用。默认值为清单条目的
enabled值。
StreamInfo
属性
-
嵌入式播放器
布尔值
如果是在嵌入式上下文（iframe/embed/object）中加载，则为 true。
-
mimeType
字符串
被拦截内容的 MIME 类型。
-
originalUrl
字符串
用户访问的原始网址。
-
responseHeaders
对象
HTTP 响应标头（键值对）。
-
streamUrl
字符串
用于提取直播数据的网址。
-
tabId
数值
包含文档的标签页 ID。
方法
abortAndFallbackToNativeHandler()
chrome.mimeHandler.abortAndFallbackToNativeHandler(
callback?: function,
): Promise<void>
中止当前流处理，并将内容移交给用户代理的原生处理程序。此调用之后，扩展程序框架将被销毁；调用方不应期望进一步执行。
参数
-
callback
函数可选
callback参数如下所示：() => void
返回
-
承诺<void>
只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
getMimeHandlerOptions()
chrome.mimeHandler.getMimeHandlerOptions(
mimeType: string,
callback?: function,
): Promise<MimeHandlerOptions>
读取 MIME 类型的选项。每个成员都是扩展程序设置的值，如果扩展程序未设置，则为清单条目的值。
参数
-
mimeType
字符串
要读取其选项的 MIME 类型。它必须是扩展程序通过 mime_types_handler 处理的 MIME 类型。
-
callback
函数可选
callback参数如下所示：(options: MimeHandlerOptions) => void
返回
-
Promise<MimeHandlerOptions>
Promise 已通过 MIME 类型的选项进行解析。
只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
getStreamInfo()
chrome.mimeHandler.getStreamInfo(
callback?: function,
): Promise<StreamInfo>
检索当前 MIME 处理程序上下文的流信息。必须从 MIME 处理程序扩展程序页面中调用。
参数
-
callback
函数可选
callback参数如下所示：(info: StreamInfo) => void
-
信息
-
返回
-
Promise<StreamInfo>
只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。
setMimeHandlerOptions()
chrome.mimeHandler.setMimeHandlerOptions(
mimeType: string,
options: MimeHandlerOptions,
callback?: function,
): Promise<void>
为指定的 MIME 类型设置配置选项。如果扩展程序在拆分无痕模式下运行，则在无痕模式下设置的选项仅适用于无痕模式，并会持续到无痕式会话结束。未在无痕模式下设置的选项会沿用在无痕模式之外设置的值。
参数
-
mimeType
字符串
要配置的 MIME 类型。它必须是扩展程序通过 mime_types_handler 处理的 MIME 类型。
-
要更改的选项。
-
callback
函数可选
callback参数如下所示：() => void
返回
-
承诺<void>
设置配置后，Promise 会解析。
只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。