scripting.getRegisteredContentScripts()
返回使用 scripting.registerContentScripts() 注册的所有内容脚本,或者在使用过滤器时返回已注册脚本的子集。
注意:此方法在 Chrome 的 Manifest V3 或更高版本以及 Firefox 101 中可用。在 Firefox 102+ 中,此方法在 Manifest V2 中也可用。
要使用此 API,您必须拥有 "scripting" 权限,并且拥有页面 URL 的权限,该权限可以明确地作为 主机权限,或者使用 activeTab 权限。
这是一个异步函数,返回一个 Promise。
语法
js
let scripts = await browser.scripting.getRegisteredContentScripts(
filter // object
)
参数
filter可选-
scripting.ContentScriptFilter。用于过滤要返回的已注册脚本详细信息的过滤器。
返回值
一个 Promise,该 Promise 会以一个 scripting.RegisteredContentScript 数组的形式得到满足。如果发生任何错误,Promise 将被拒绝。
示例
此示例返回所有已注册的内容脚本
js
// Register two content scripts.
await browser.scripting.registerContentScripts([
{
id: "script-1",
js: ["script-1.js"],
matches: ["*://example.com/*"],
},
{
id: "script-2",
js: ["script-2.js"],
matches: ["*://example.com/*"],
},
]);
// Retrieve all content scripts.
let scripts = await browser.scripting.getRegisteredContentScripts();
console.log(scripts.map((script) => script.id)); // ["script-1", "script-2"]
// Only retrieve the second script.
scripts = await browser.scripting.getRegisteredContentScripts({
ids: ["script-2"],
});
console.log(scripts.map((script) => script.id)); // ["script-2"]
浏览器兼容性
加载中…
注意:此 API 基于 Chromium 的 chrome.scripting API。