用js开发chrome扩展插件史上最全详细教程

另外,本文图片较多,且图片服务器带宽有限,右下角的目录滚动监听必须等到图片全部加载完毕之后才会触发,所以请耐心等待加载完毕。

严格来讲,我们正在说的东西应该叫Chrome扩展(ChromeExtension),真正意义上的Chrome插件是更底层的浏览器功能扩展,可能需要对浏览器源码有一定掌握才有能力去开发。鉴于Chrome插件的叫法已经习惯,本文也全部采用这种叫法,但读者需深知本文所描述的Chrome插件实际上指的是Chrome扩展。

个人猜测crx可能是ChromeExtension如下3个字母的简写:

另外,其实不只是前端技术,Chrome插件还可以配合C++编写的dll动态链接库实现一些更底层的功能(NPAPI),比如全屏幕截图。

由于安全原因,Chrome浏览器42以上版本已经陆续不再支持NPAPI插件,取而代之的是更安全的PPAPI。

增强浏览器功能,轻松实现属于自己的“定制版”浏览器,等等。

Chrome插件提供了很多实用API供我们使用,包括但不限于:

Chrome插件没有严格的项目结构要求,只要保证本目录有一个manifest.json即可,也不需要专门的IDE,普通的web开发工具即可。

勾选开发者模式即可以文件夹的形式直接加载插件,否则只能安装.crx格式的文件。Chrome要求插件必须从它的Chrome应用商店安装,其它任何网站下载的都无法直接安装,所以,其实我们可以把crx文件解压,然后通过开发者模式直接加载。

开发中,代码有任何改动都必须重新加载插件,只需要在插件管理页按下Ctrl+R即可,以防万一最好还把页面刷新一下。

示例配置:

其实看到这里不要悲观,这些API绝大部分时候都够用了,非要调用其它API的话,你还可以通过通信来实现让background来帮你调用(关于通信,后文有详细介绍)。

好了,Chrome插件给我们提供了这么强大的JS注入功能,剩下的就是发挥你的想象力去玩弄浏览器了。

后台(姑且这么翻译吧),是一个常驻的页面,它的生命周期是插件中所有类型页面中最长的,它随着浏览器的打开而打开,随着浏览器的关闭而关闭,所以通常把需要一直运行的、启动就运行的、全局的代码放在background里面。

background的权限非常高,几乎可以调用所有的Chrome扩展API(除了devtools),而且它可以无限制跨域,也就是可以跨域访问任何网站而无需要求对方设置CORS。

经过测试,其实不止是background,所有的直接通过chrome-extension://id/xx.html这种方式打开的网页都可以无限制跨域。

配置中,background可以通过page指定一张网页,也可以通过scripts直接指定一个JS,Chrome会自动为这个JS生成一个默认的网页:

{//会一直常驻的后台JS或后台页面"background":{//2种指定方式,如果指定JS,那么会自动生成一个背景页"page":"background.html"//"scripts":["js/background.js"]},}需要特别说明的是,虽然你可以通过chrome-extension://xxx/background.html直接打开后台页,但是你打开的后台页和真正一直在后台运行的那个页面不是同一个,换句话说,你可以打开无数个background.html,但是真正在后台常驻的只有一个,而且这个你永远看不到它的界面,只能调试它的代码。

{"background":{"scripts":["event-page.js"],"persistent":false},}它的生命周期是:在被需要时加载,在空闲时被关闭,什么叫被需要时呢?比如第一次安装、插件更新、有content-script向它发送消息,等等。

除了配置文件的变化,代码上也有一些细微变化,个人这个简单了解一下就行了,一般情况下background也不会很消耗性能的。

popup是点击browser_action或者page_action图标时打开的一个小窗口网页,焦点离开网页就立即关闭,一般用来做一些临时性的交互。

popup可以包含任意你想要的HTML内容,并且会自适应大小。可以通过default_popup字段来指定popup页面,也可以调用setPopup()方法。

配置方式:

在权限上,它和background非常类似,它们之间最大的不同是生命周期的不同,popup中可以直接通过chrome.extension.getBackgroundPage()获取background的window对象。

这里的injected-script是我给它取的,指的是通过DOM操作的方式向页面注入的一种JS。为什么要把这种JS单独拿出来讨论呢?又或者说为什么需要通过这种方式注入JS呢?

这是因为content-script有一个很大的“缺陷”,也就是无法访问页面中的JS,虽然它可以操作DOM,但是DOM却不能调用它,也就是无法在DOM中通过绑定事件的方式调用content-script中的代码(包括直接写onclick和addEventListener2种方式都不行),但是,“在页面上添加一个按钮并调用插件的扩展API”是一个很常见的需求,那该怎么办呢?其实这就是本小节要讲的。

在content-script中通过DOM方式向页面注入inject-script代码示例:

{//普通页面能够直接访问的插件资源列表,如果不设置是无法直接访问的"web_accessible_resources":["js/inject.js"],}至于inject-script如何调用content-script中的代码,后面我会在专门的一个消息通信章节详细介绍。

开发者或者插件主页设置,一般会在如下2个地方显示:

通过配置browser_action可以在浏览器的右上角增加一个图标,一个browser_action可以拥有一个图标,一个tooltip,一个badge和一个popup。

示例配置如下:

"browser_action":{"default_icon":"img/icon.png","default_title":"这是一个示例Chrome插件","default_popup":"popup.html"}5.1.1.图标browser_action图标推荐使用宽高都为19像素的图片,更大的图标会被缩小,格式随意,一般推荐png,可以通过manifest中default_icon字段配置,也可以调用setIcon()方法。

修改browser_action的manifest中default_title字段,或者调用setTitle()方法。

所谓badge就是在图标上显示一些文本,可以用来更新一些小的扩展状态提示信息。因为badge空间有限,所以只支持4个以下的字符(英文4个,中文2个)。badge无法通过配置文件来指定,必须通过代码实现,设置badge文字和颜色可以分别使用setBadgeText()和setBadgeBackgroundColor()。

所谓pageAction,指的是只有当某些特定页面打开才显示的图标,它和browserAction最大的区别是一个始终都显示,一个只在特定情况才显示。

而新版的Chrome更改了这一策略,pageAction和普通的browserAction一样也是放在浏览器右上角,只不过没有点亮时是灰色的,点亮了才是彩色的,灰色时无论左键还是右键单击都是弹出选项:

具体是从哪一版本开始改的没去仔细考究,反正知道v50.0的时候还是前者,v58.0的时候已改为后者。

调整之后的pageAction我们可以简单地把它看成是可以置灰的browserAction。

示例(只有打开百度才显示图标):

通过开发Chrome插件可以自定义浏览器的右键菜单,主要是通过chrome.contextMenusAPI实现,右键菜单可以出现在不同的上下文,比如普通页面、选中的文字、图片、链接,等等,如果有同一个插件里面定义了多个菜单,Chrome会自动组合放到以插件名字命名的二级菜单里,如下:

扩展可以替代如下页面:

注意:

下面的截图是默认的新标签页和被扩展替换掉的新标签页。

代码(注意,一个插件只能替代一个默认页,以下仅为演示):

"chrome_url_overrides":{"newtab":"newtab.html","history":"history.html","bookmarks":"bookmarks.html"}5.5.devtools(开发者工具)5.5.1.预热使用过vue的应该见过这种类型的插件:

是的,Chrome允许插件在开发者工具(devtools)上动手脚,主要表现在:

先来看2张简单的demo截图,自定义面板(判断当前页面是否使用了jQuery):

自定义侧边栏(获取当前页面所有图片):

来一张官方图片:

每打开一个开发者工具窗口,都会创建devtools页面的实例,F12窗口关闭,页面也随着关闭,所以devtools页面的生命周期和devtools窗口是一致的。devtools页面可以访问一组特有的DevToolsAPI以及有限的扩展API,这组特有的DevToolsAPI只有devtools页面才可以访问,background都无权访问,这些API包括:

大部分扩展API都无法直接被DevTools页面调用,但它可以像content-script一样直接调用chrome.extension和chrome.runtimeAPI,同时它也可以像content-script一样使用Message交互的方式与background页面进行通信。

{//只能指向一个HTML文件,不能是JS文件"devtools_page":"devtools.html"}这个devtools.html里面一般什么都没有,就引入一个js:

可以看出来,其实真正代码是devtools.js,html文件是“多余”的,所以这里觉得有点坑,devtools_page干嘛不允许直接指定JS呢?

再来看devtools.js的代码:

以下截图示例的代码:

所谓options页,就是插件的设置页面,有2个入口,一个是右键图标有一个“选项”菜单,还有一个在插件管理页面:

在Chrome40以前,options页面和其它普通页面没什么区别,Chrome40以后则有了一些变化。

{//Chrome40以前的插件配置页写法"options_page":"options.html",}这个页面里面的内容就随你自己发挥了,配置之后在插件管理页就会看到一个选项按钮入口,点进去就是打开一个网页,没啥好讲的。

效果:

{"options_ui":{"page":"options.html",//添加一些默认的样式,推荐使用"chrome_style":true},}options.html的代码我们没有任何改动,只是配置文件改了,之后效果如下:

看起来是不是高大上了?

几点注意:

omnibox是向用户提供搜索建议的一种方式。先来看个gif图以便了解一下这东西到底是个什么鬼:

注册某个关键字以触发插件自己的搜索建议界面,然后可以任意发挥了。

首先,配置文件如下:

{//向地址栏注册一个关键字以提供搜索建议,只能设置一个关键字"omnibox":{"keyword":"go"},}然后background.js中注册监听事件:

在后台JS中,无论是使用chrome.notifications还是Notification都不需要申请权限(HTML5方式需要申请权限),直接使用即可。

最简单的通知:

代码:

这个没有深入研究,有需要的可以去看官方文档。

Chrome插件的JS主要可以分为这5类:injectedscript、content-script、popupjs、backgroundjs和devtoolsjs,

前面我们介绍了Chrome插件中存在的5种JS,那么它们之间如何互相通信呢?下面先来系统概况一下,然后再分类细说。需要知道的是,popup和background其实几乎可以视为一种东西,因为它们可访问的API都一样、通信机制一样、都可以跨域。

注:-表示不存在或者无意义,或者待验证。

popup可以直接调用background中的JS方法,也可以直接访问background的DOM:

至于background访问popup如下(前提是popup已经打开):

网上有些老代码中用的是chrome.extension.onMessage,没有完全查清二者的区别(貌似是别名),但是建议统一使用chrome.runtime.onMessage。

content-script.js:

content-script和页面内的脚本(injected-script自然也属于页面内的脚本)之间唯一共享的东西就是页面的DOM元素,有2种方法可以实现二者通讯:

第一种方法(推荐):

injected-script中:

window.addEventListener("message",function(e){console.log(e.data);},false);第二种方法:

短连接的话就是挤牙膏一样,我发送一下,你收到了再回复一下,如果对方不回复,你只能重新发,而长连接类似WebSocket会一直建立连接,双方可以随时互发消息。

短连接上面已经有代码示例了,这里只讲一下长连接。

popup.js:

示例manifest.json配置:

//获取当前选项卡IDfunctiongetCurrentTabId(callback){chrome.tabs.query({active:true,currentWindow:true},function(tabs){if(callback)callback(tabs.lengthtabs[0].id:null);});}获取当前选项卡id的另一种方法,大部分时候都类似,只有少部分时候会不一样(例如当窗口最小化时)

//获取当前选项卡IDfunctiongetCurrentTabId2(){chrome.windows.getCurrent(function(currentWindow){chrome.tabs.query({active:true,windowId:currentWindow.id},function(tabs){if(callback)callback(tabs.lengthtabs[0].id:null);});});}8.5.本地存储本地存储建议用chrome.storage而不是普通的localStorage,区别有好几点,个人认为最重要的2点区别是:

_locales\en\messages.json内容:

{"pluginDesc":{"message":"Asimplechromeextensiondemo"},"helloWorld":{"message":"HelloWorld!"}}_locales\zh_CN\messages.json内容:

{"pluginDesc":{"message":"一个简单的Chrome插件demo"},"helloWorld":{"message":"你好啊,世界!"}}在manifest.json和CSS文件中通过__MSG_messagename__引入,如:

{"description":"__MSG_pluginDesc__",//默认语言"default_locale":"zh_CN",}JS中则直接chrome.i18n.getMessage("helloWorld")。

测试时,通过给chrome建立一个不同的快捷方式chrome.exe--lang=en来切换语言,如:

英文效果:

中文效果:

比较常用用的一些API系列:

已安装的插件源码路径:C:\Users\用户名\AppData\Local\Google\Chrome\UserData\Default\Extensions,每一个插件被放在以插件ID为名的文件夹里面,想要学习某个插件的某个功能是如何实现的,看人家的源码是最好的方法了:

很多时候你发现你的代码会莫名其妙的失效,找来找去又找不到原因,这时打开background的控制台才发现原来某个地方写错了导致代码没生效,正式由于background报错的隐蔽性(需要主动打开对应的控制台才能看到错误),所以特别注意这点。

在对popup页面审查元素的时候popup会被强制打开无法关闭,只有控制台关闭了才可以关闭popup,原因很简单:如果popup关闭了控制台就没用了。这种方法在某些情况下很实用!

也就是不支持将js直接写在html中,比如:

报错如下:

如果这样写:

之所以强调这个,是因为这个带来的问题非常隐蔽,不太容易找到,可能你正在写某个网页,昨天样式还是好好的,怎么今天就突然不行了?然后你辛辛苦苦找来找去,找了半天才发现竟然是因为插件里面的一个样式影响的!

打包的话直接在插件管理页有一个打包按钮:

推荐查看官方文档,虽然是英文,但是全且新,国内的中文资料都比较旧(注意以下全部需要FQ):

THE END
1.玩家热议:部分游戏菜单仅提供保存选项在Reddit的游戏论坛上,最近有一个话题引起了热烈的讨论。一些玩家抱怨某些游戏菜单只提供了存储功能,而没有读取功能,这让它们感到非常奇怪。有玩家猜测这可能是为了防止误操作。 一位玩家在《星球工匠》的主菜单上发现了这个问题,只设置了存储键,没有读取键。他对此表示不满,并呼吁官方能够同时提供这两种功能。实际上https://m.dancihu.com/article/75300.html
2.menu是什么意思功能操作菜单车上的每个功能按钮都很重要,那么menu是什么意思呢?menu代表汽车的功能操作菜单。这个词一般出现在汽车的中控面板上。通过点击菜单按钮,可以切换功能菜单,方便用户在使用多媒体时的操作。 其他字母含义 我们继续来看看汽车上其他英文字母的含义,比如:sos代表车载自救救援系统,at代表自动变速器,eco代表汽车的经济节能模式,https://www.pcauto.com.cn/cxxj/3405/34054321.html
3.menu键在哪里菜单键(Menu键)的位置可能因设备和操作系统的不同而异。一般来说,菜单键通常位于设备的物理键盘或触摸屏上。以下是几种常见设备和情境下菜单键的位置: 1. 在电脑键盘中,一般笔记本电脑和台式电脑都在键盘左下角或右下角标有功能图标的位置,会有一个菜单标识(通常是三个横线)的按键,这就是菜单键。有些键盘http://m.yuhuajinling.com/kjwdzx/202411/254064.html
4.食物和饮料饭(faan6)米饭饭香面滑最滋味:用“饭”和“面”描述主食的美味。 菜鲜汤热暖心扉:用“菜”和“汤”搭配,表达营养和温馨的感受。 小酌几杯酒添情趣:用“酒”表示适量饮用带来的愉悦氛围。 闲时品茶解乏累:用“茶”表达喝茶放松的日常情景。 水清润喉是日常:用“水”强调健康的基础饮品。 https://blog.csdn.net/m0_50272029/article/details/144271034
5.西餐菜品英语翻译指南:从开胃菜到甜点!西餐文化博大精深,其菜式名称更是琳琅满目。从开胃菜到主菜,从配菜到甜点,每一味佳肴都拥有一个优雅且精准的英文名称。本文将从四方面详细阐述西餐菜品英文名称的表达方式,带领读者领略西餐语言的魅力。 一、开胃菜 西餐中的开胃菜,旨在刺激食欲,为之后的用餐做好准备。 https://www.coffee.cn/xican/post/482200.html
6.sauce是什么意思sauce的翻译(sauce是什么意思英语翻译成中文以下是关于sauce是什么意思sauce的翻译(sauce是什么意思英语翻译成中文)的介绍 1、sauce是什么意思sauce的翻译 Sauce是一个常用的英文单词,它可以用作名词和动词,具有不同的意义。作为名词,sauce的意思是“调味汁”,“酱汁”,或者“液体调料”。它可以用于制作沙拉、面条和肉类等食品,以增添口味和美味度。 http://www.ouyu158.com/show-990232.html
7.ak.akvtc.cn/mokoi12报告书指出,“虽然美国与俄罗斯正按2011年签署的《美俄新削减战略武器协议》减少核武器数量,但这两个国家却同时在推进核弹头的现代化,并在开展促进核弹头生产设备和运输系统现代化的有关项目”。 文在寅认为,循环出资问题导致韩国大企业无限扩张自己的经营范围,侵害小巷经济,因此必须加以防范和惩处,只有禁止所有循环http://ak.akvtc.cn/mokoi12_02/872665.html
8.www.jmhengai.org/news.php/763444.htm扶老二app 换q交流经验真实 女人越说疼男生越往里寨视频 特特特特特特黄片 xxx18x免费 ass少妇女下部轻典qiac 国产女性AV兵 在線能看的大型黃色毛片兒 亚洲免费看小视频 全射给你吃掉它原视频高清 欧美精品一区二区三区在线四季 女儿就是用来亨用的2 少妇spa推油按摩aⅤ 韩日午夜在线资源一区二区http://www.jmhengai.org/news.php/763444.htm
9.?餐厅点餐必备:英文缩写大揭秘希望这些缩写能帮助你在餐厅点餐时更加得心应手,享受美食的同时,也能更好地理解菜单上的各种英文缩写哦!0 0 发表评论 发表 作者最近动态 考Yan小魔王不怕苦 2024-11-30 美国留学:化学专业的高薪与顶尖院校推荐 全文 考Yan小魔王不怕苦 2024-11-30 广州小雨中的非遗角雕体验:从零件到艺术品全文 https://mbd.baidu.com/newspage/data/dtlandingsuper?nid=dt_4780826410087641683
10.chrome插件开发干货转从右上角菜单->更多工具->扩展程序可以进入 插件管理页面,也可以直接在地址栏输入chrome://extensions访问。 勾选开发者模式即可以文件夹的形式直接加载插件,否则只能安装.crx格式的文件。Chrome要求插件必须从它的Chrome应用商店安装,其它任何网站下载的都无法直接安装,所以,其实我们可以把crx文件解压,然后通过开发者模式https://zhuanlan.zhihu.com/p/37136966
11.www.jxmzxx.com{$woaini}>www.jxmzxx.com{$woaini}今年58岁的秦玉风两年前以“银龄教师”的身份来到盐池三中教授初中毕业班的历史课。她于2021年3月底退休,此前已担任中学历史教师30多年。95后刘建伟和秦玉风同在2022年入职盐池三中担任历史教师。刘建伟认为,秦老师这样的银龄教师有丰富的课堂经验,能为年轻教师提供宝贵的教学范本。 http://www.jxmzxx.com/appnews_20241128/45181611
12.百度翻译官方电脑版菜单翻译应该也是拍照功能里不好用的一个了,我们在网络上找到一份菜单之后使用百度翻译去识别,但是其识别出的翻译内容也仅仅是字面意思,但是我们还是不知道这其中的某些菜品究竟是什么,实用性方面还是有待于加强。 有的时候我们出去旅游经常会碰到某些问题需要向当地人请教,但是更多的时候却是无奈与外语能力不好,为此百http://soft.5119.cn/soft/495663.htm
13.web.yjsuoj.com/nodenews/720573.htm坐台小姐电影百度影音 360补漏黑色主题6月7 人文艺术课拍377八文芒节 描写进入的那一刻感受文章 黄色录像app 真人私处写真 小龙女洁白双腿张开娇羞 黄免费网站www 女友的妈妈4完整视频有翻译英文 亚洲国产精品无码久久久久高潮_中文字幕在线乱码免费毛片_ 免费麻花豆传媒剧国产在线观看 没带罩子让同学捏了一http://web.yjsuoj.com/nodenews/720573.htm
14.和秋叶一起学PPT(第5版)过去绝大部分讲PPT功能的图书都是按照软件功能来组织内容的:要么按菜单功能逐一介绍,要么按版式、文字、表格、图表、动画的顺序来介绍,再搭配着讲几个案例。我们觉得这些组织模式都不错,但看完之后,学习者的PPT制作能力能提升多少呢? 所以,本书采用了如下组织模式。 https://labs.epubit.com/bookDetails?id=UB831725a36acde
15.网奇=APP艺术家网奇公司的每位开发团队工程师 至少5年以上经验,拒绝毕业生 服务体系统 全国独家“五赞”诚信技术服务体系 用优质的服务为我们立口碑 我们致力于为您 打造一件:APP艺术品 互联网+城市生活四网合一平台开发手机APP和网站建设 五赞服务体系Five Zan Service System http://www.wangqi.com/
16.初三信息技术中考题(通用6篇)23、单击“开始”菜单中的“运行”,在“打开”输入框中输入(),单击“确定”按钮,可以进入DOS命令用户界面。A、=dos B、=command C、=windows D、=命令 24、在Windows 98中,能弹出对话框的操作是()。A、选择了带省略号的菜单项 B、选择了带向右三角形箭头的菜单项 C、选择了颜色变灰的菜单项 https://www.360wenmi.com/f/filea0bqupjt.html
17.Android开发adbmonkey测试一般涉及界面(如菜单、对话框、窗口和其他可视控件)布局、风格、文字是否正确,页面是否美观,操作是否友好。 如:安装app后的加载页显示,分享页面的产品logo显示 1.1.10.兼容性测试 我再说一下兼容性测试吧,兼容性测试主要考虑手机的版本,型号,分辨率,就像我说的,现在手机碎片化比较严重,各个版本,比如Android,从Androidhttps://www.jianshu.com/p/e73c387b1920