一篇文章入门Chrome扩展开发

Chrome扩展是什么

Chrome extension看着像一个app,我们经常会误认为它是一个exe或者是一个app。但是就本质而言,Chrome extension是一个网页。它由manifest.json配置文件以及一系列的html、css、js、图片等组成。所以对于一个前端开发而言,写一个Chrome扩展是一个不算太难的事情。

一个扩展的基础组成

Chrome扩展都包含一个Manifest文件——manifest.json,这个文件可以告诉Chrome关于这个扩展的相关信息,它是整个扩展的入口,也是Chrome扩展必不可少的部分。

Chrome扩展的Manifest必须包含name(名称)、version(版本)和manifest_version属性,目前来说manifest_version属性值只能为数字2。

其他常用的可选属性还有browser_actionpage_actionbackgroundpermissionsoptions_pagecontent_scripts

官方有给出一份完整的Manifest.json的属性列表

以下是一份从官方复制过来的manifest.json文件,我对它进行了一下简略处理,可以先感受一下,从这里可以大致的看到一个扩展书写的规则。

 {
  // Required
  "manifest_version": 2,
  "name": "My Extension",
  "version": "versionString",
 ​
  // Recommended
  "default_locale": "en",
  "description": "A plain text description",
  "icons": {...},
 ​
  // Pick one (or none)
  "browser_action": {...},
  "page_action": {...},
 ​
  // Optional
  "action": ...,
  "author": ...,
  "automation": ...,
  "background": {
  // Recommended
  "persistent": false,
  // Optional
  "service_worker":
  },
  "homepage_url": "http://path/to/homepage",
  "permissions": ["tabs"]
 }

我们来看一下其中一些配置项的意义。

首先是必填的几个属性

  • name:名称

  • version:版本

  • manifest_version:只能为2

其次是几个我认为有必要说明一下的:

  • icon:扩展程序的图标,可以有一个或多个。使用的地方有很多,比如用在extensions的管理界面,安装extension程序的时候等等。

  • browser_actionpage_action

 "browser_action": {
      "default_icon": {
        "19": "images/icon19.png",
        "38": "images/icon38.png"
      },
      "default_title": "我的时钟",
      "default_popup": "popup.html"
}

brower_actionpage_action的功能类似,都是用来处理扩展在浏览器工具栏上的表现行为。 brower_action扩展可以适用于任何页面。page_action扩展只能作用于某一页面,当打开该页面时触发该Google Chrome扩展,关闭页面则Google Chrome扩展也随之消失。

browser_action指定扩展的图标放在Chrome的工具栏中,browser_action中的default_icon属性定义了相应图标文件的位置,default_title定义了当用户鼠标悬停于扩展图标上所显示的文字,default_popup则定义了当用户单击扩展图标时所显示页面的文件位置。

  • content_scripts
 "content_scripts": [
      {
      "matches": ["*://www.google.com/"],
      "js": ["js/...js"]
      }
]

如果你想要你的扩展可以操作用户页面,就需要用到这个属性。这个属性可以指定将哪些脚本何时注入到哪些页面中,当用户访问这些页面后,相应脚本即可自动运行,从而对页面DOM进行操作。切这个属性只与页面共享DOM,而不与页面中的js共享命名空间。

content_scripts属性值为数组类型,数组的每个元素可以包含matchesexclude_matchescssjsrun_atall_framesinclude_globsexclude_globs等属性
-- matches定义了哪些页面会被注入脚本
-- exclude_matches定义了哪些页面不会被注入脚本
-- css和js定义了需要被注入页面的js和css
-- run_at定义了何时被注入

  • permissions
    由于浏览器受限于同源策略,但是如果extension也需要受限的话,功能实现会大打折扣,所以chrome是允许extensions不受同源策略影响的,只不过需要进行一些额外的操作。
 {
      ...
      "permissions": [
        "third party url"
      ]
 }

比如说,你需要获取到一个第三方页面的数据,就需要在permissions中进行声明。再比如说,在background里使用一些高级的chrome api(downloads,webRequest,proxy,system等),这些api也是需要授权才能使用的。如果对高级api用法感兴趣可以在官方文档中查询。

  • background

如果你的扩展需要常驻后台,比如实现一些实时推送的功能。那就需要用到这个属性。background可以包含三种属性,分别是scriptspagepersistent。通常来说,我们只需要使用到scripts。如果指定了scripts`属性,则Chrome会在扩展启动时自动创建一个包含所有指定脚本的页面。persistent属性描述了常驻后台的方式,可选值为true和false。

更多属性大家可以参照上方链接中给出的官方文档说明,发掘一下还是可以创造出很多有意思的功能的。

数据存储

我们写一个程序不可避免都是需要用到数据存储的,对于Chrome扩展也是这样。

通常来说,Chrome扩展用到的存储方式有三种,localStorage,Chrome提供的存储API,web SQL Database。

localStorage的使用众所周知,这边就不赘述。

Chrome提供的存储API是对localStorage的改进,它与localStorage相比有以下区别:

  • 如果储存区域指定为sync,数据可以自动同步到用户当前在Chrome上登陆的Google账户,如果没有网络连接的话,sync储存的数据的读写与local一致;

  • content_scripts可以直接读取数据,而不必通过background页面,区别于localStorage需要受限于域名;

  • 在隐身模式下仍然可以读出之前存储的数据;

  • 读写速度更快;

  • 用户数据可以以对象的类型保存。

值得注意的是,使用Chrome存储API必须要在Manifest的permissions中声明,之后才有权限调用。

chrome.storage.StorageArea提供了5个方法,分别是getgetBytesInUsesetremoveclear

get用于读取数据,set用于写入数据,remove用于删除数据,clear用于清空数据,getBytesInUse方法为获取一个数据或多个数据所占用的总空间,返回结果的单位是字节。

扩展页面间通信

对于页面间的通信,chrome提供了4个页面之间通信的接口。

  • runtime.sendMessage

  • runtime.onMessage

  • runime.connect,更高级用法,参考官方文档

  • runtime.onConnect,更高级用法,参考官方文档

这一节主要说一下sengMessage和onMessage。

一般而言,chrome提供的API是不允许在content_scripts中运行的,但是runtime.sendMessageruntime.onMessage可以。所以扩展的其他页面也可以同content_scripts相互通信。

用法如下:

 chrome.runtime.sendMessage(extensionId, message, options, callback)</pre>
  • extensionId为所发送消息的目标扩展,如果不指定这个值,则默认为发起此消息的扩展本身;

  • message为要发送的内容,类型随意,内容随意;

  • options是一个可选参数,属性的值决定扩展发起此消息时是否要将TLS通道ID发送给监听此消息的外部扩展。tls参考文档

  • callback回调函数,用于接收返回结果;

chrome.runtime.onMessage.addListener(callback)

此处的callback为必选参数,为回调函数。callback接收到的参数有三个,分别是messagesendersendResponse,即消息内容、消息发送者相关信息和相应函数。

chrome扩展推荐

最后推荐几个我自己常用的扩展。

  • 草料二维码,非常方便将url转化成二维码
  • 1px,用于和前端页面和设计稿进行还原度对比
  • charset,方便修改当前页面的charset
  • Momentum,chrome新开页自定义dashboard

参考资料

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342