Chrome 浏览器插件 V3 版本 Manifest.json 文件中 Action 的类型(Types)、方法(Methods)和事件(Events)的属性和参数解析
1.Chrome 浏览器插件 V3 版本 Manifest.json 文件中 Action 的类型(Types)、方法(Methods)和事件(Events)的属性和参数解析
2.Chrome 插件 V3 版本 Manifest.json 中的内容脚本(Content Scripts)解析3.Chrome 插件 V3 版本 Manifest.json 中的内容脚本(Content Scripts)解析4.Chrome 浏览器插件 Manifest.json V3 中权限(Permissions)字段解析5.Chrome 浏览器插件获取网页 window 对象(方案一)一、类型(Types
)
一、OpenPopupOptions
1. 属性
windowId: number
可选- 打开操作弹出式窗口的窗口
ID
。如果未指定,则默认为当前活动窗口。
- 打开操作弹出式窗口的窗口
二、TabDetails
1. 属性
tabId: number
可选- 要查询其状态的标签页
ID
。如果未指定标签页,则返回非标签页专属状态。
- 要查询其状态的标签页
三、UserSettings
与扩展程序操作相关的用户指定设置的集合。
1. 属性
isOnToolbar: boolean
- 扩展程序的操作图标是否显示在浏览器窗口的顶级工具栏中(例如,用户是否已“固定”扩展程序)。
二、方法(Methods
)
一、disable()
停用标签页操作。
1. 示例
chrome.action.disable(
tabId?: number,
callback?: function,
)
2. 参数
tabId: number
可选- 要为其修改操作的标签页的
ID
。
- 要为其修改操作的标签页的
callback: function
(可选)callback
参数如下所示:
()=>void
3. 返回
Promise<void>
二、enable()
为标签页启用操作。默认情况下,操作处于启用状态。
1. 示例
chrome.action.enable(
tabId?: number,
callback?: function,
)
2. 参数
tabId: number
可选- 要为其修改操作的标签页的
ID
。
- 要为其修改操作的标签页的
callback: function
(可选)callback
参数如下所示
()=>void
3. 返回
Promise<void>
三、getBadgeBackgroundColor()
获取操作的背景颜色。
1. 示例
chrome.action.getBadgeBackgroundColor(
details: TabDetails,
callback?: function,
)
2. 参数
details
:TabDetails
callback function
(可选)callback
参数如下所示
(result:ColorArray)=>void
3. 返回
Promise<
browserAction.ColorArray
>
ColorArray: [number, number, number, number]
四、getBadgeText()
获取操作的标记文本。
如果未指定标签页,则返回非标签页专用标志文本。如果启用了 displayActionCountAsBadgeText
,则系统将返回占位符文本,除非存在 declarativeNetRequestFeedback
权限或提供了标签页专用的标记文本。
1. 示例
chrome.action.getBadgeText(
details: TabDetails,
callback?: function,
)
2. 参数
details:
TabDetails
callback: function
(可选)callback
参数如下所示:
(result: string)=>void
3. 返回
Promise<string>
五、getBadgeTextColor()
获取操作的文本颜色。
1. 示例
chrome.action.getBadgeTextColor(
details: TabDetails,
callback?: function,
)
2. 参数
details:
TabDetails
callback
functioon
(可选)callback
参数如下所示:
(result: ColorArray)=>void
3. 返回
Promise<
browserAction.ColorArray
>
六、getPopup()
获取设置为此操作的弹出式窗口的 HTML
文档。
1. 示例
chrome.action.getPopup(
details: TabDetails,
callback?: function,
)
2. 参数
details:
TabDetails
callback function
(可选)callback
参数如下所示:
(result:string)=>void
3. 返回
Promise<string>
七、getTitle()
获取操作的标题。
1. 示例
chrome.action.getTitle(
details: TabDetails,
callback?: function,
)
2. 参数
details:
TabDetails
callback: function
(可选)callback
参数如下所示:
(result: string)=>void
3. 返回
Promise<string>
八、getUserSettings()
返回与扩展程序操作相关的用户指定设置。
1. 示例
chrome.action.getUserSettings(
callback?: function,
)
2. 参数
callback: function
(可选)callback
参数如下所示:
(userSettings: UserSettings)=>void
3. 返回
Promise<
UserSettings
>
九、isEnabled()
指示是否已为标签页启用扩展程序操作(如果未提供 tabId,则是在全局范围内启用)。仅使用 declarativeContent 启用的操作始终返回 false。
1. 示例
chrome.action.isEnabled(
tabId?: number,
callback?: function,
)
2. 参数
tabId: number
可选- 要检查其启用状态的标签页的
ID
。
- 要检查其启用状态的标签页的
callback: function
(可选)callback
参数如下所示:
(isEnabled: boolean)=>void
3. 返回
Promise<boolean>
十、openPopup()
打开扩展程序的弹出式窗口。
1. 示例
chrome.action.openPopup(
options?: OpenPopupOptions,
callback?: function,
)
2. 参数
options:
OpenPopupOptions
可选- 指定用于打开弹出式窗口的选项。
callback: function
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
十一、setBadgeBackgroundColor()
设置标志的背景颜色。
1. 示例
chrome.action.setBadgeBackgroundColor(
details: object,
callback?: function,
)
2. 参数
details: object
color: string|ColorArray
ColorArray
一个由 [0,255] 范围内的四个整数组成的数组,这些整数构成了徽章的 RGBA 颜色。例如,不透明的红色为 [255, 0, 0, 255]。也可以是具有CSS
值的字符串,其中不透明红色为#FF0000
或#F00
。
tabId: number
可选- 将更改限制为选择特定标签页的时间。关闭标签页后自动重置。
callback: function
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
十二、setBadgeText()
设置操作的标记文本。标记会显示在图标顶部。
1. 示例
chrome.action.setBadgeText(
details: object,
callback?: function,
)
2. 参数
details: object
tabId: number
可选- 将更改限制为选择特定标签页的时间。关闭标签页后自动重置。
text: string
(可选)- 可以传递任意数量的字符,但不得超过四个字符。如果传递了空字符串 (''),标志文本将被清除。如果指定了
tabId
且text
为null
,指定标签页的文本将会被清除,并默认为全局标记文本。
- 可以传递任意数量的字符,但不得超过四个字符。如果传递了空字符串 (''),标志文本将被清除。如果指定了
callback: function
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
十三、setBadgeTextColor()
设置标志的文本颜色。
1. 示例
chrome.action.setBadgeTextColor(
details: object,
callback?: function,
)
2. 参数
details: object
color: string|ColorArray
tabId: number
可选- 将更改限制为选择特定标签页的时间。关闭标签页后自动重置。
callback: function
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
十四、setIcon()
设置操作的图标。
可将图标指定为图像文件的路径、画布元素的像素数据或上述任何一项的字典。必须指定 path
或 imageData
属性。
1. 示例
chrome.action.setIcon(
details: object,
callback?: function,
)
2. 参数
details: object
imageData:
ImageData
|object
(可选)ImageData
对象或表示要设置的图标的 {size -> ImageData
} 字典。如果将图标指定为字典,则系统会根据屏幕的像素密度选择要使用的实际图片。如果适合一个屏幕空间单位的图片像素数等于scale
,则系统会选择尺寸为scale * n
的图片,其中n
是界面中图标的尺寸。必须至少指定一张图片。请注意,"details.imageData = foo"
等同于"details.imageData = {'16': foo}"
path
:string|object
****可选- 相对图片路径或指向要设置的图标的字典 {
size -> relative image path
}。
- 相对图片路径或指向要设置的图标的字典 {
tabId: number
可选- 将更改限制为选择特定标签页的时间。关闭标签页后自动重置。
callback: function
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
十五、setPopup()
设置 HTML 文档,使其在用户点击操作的图标时以弹出式窗口的形式打开。
1. 示例
chrome.action.setPopup(
details: object,
callback?: function,
)
2. 参数
details: object
popup:
string
- 要在弹出式窗口中显示的
HTML
文件的相对路径。如果设置为空字符串 (''),系统不会显示弹出式窗口。
- 要在弹出式窗口中显示的
tabId: number
可选- 将更改限制为选择特定标签页的时间。关闭标签页后自动重置。
callback: function
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
十六、setTitle()
设置操作的标题。这会显示在提示中。
1. 示例
chrome.action.setTitle(
details: object,
callback?: function,
)
2. 参数
details: object
tabId: number
可选- 将更改限制为选择特定标签页的时间。关闭标签页后自动重置。
- title: string
- 鼠标悬停时,操作应显示的字符串。
callback: funtion
(可选)callback
参数如下所示:()=>void
3. 返回
Promise<void>
三、事件(Events
)
一、onClicked
点击操作图标时触发。
如果操作具有弹出式窗口,则不会触发此事件。
1. 示例
chrome.action.onClicked.addListener(
callback: function,
)
2. 参数
callback: function
callback
参数如下所示:
(tab: tabs.Tab)=>void
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· AI与.NET技术实操系列(二):开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识(上)
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 全程不用写代码,我用AI程序员写了一个飞机大战
· DeepSeek 开源周回顾「GitHub 热点速览」
· 记一次.NET内存居高不下排查解决与启示
· MongoDB 8.0这个新功能碉堡了,比商业数据库还牛
· .NET10 - 预览版1新功能体验(一)