Chrome Extensionで選択した場所にモザイクをかける拡張機能を作って公開するまでの話(初心者向けChrome Extension講座)

# Chrome Extensionとは

所謂Chrome拡張と呼ばれるブラウザ用の拡張機能のことです。具体的には[Chrome ウェブストア](https://chrome.google.com/webstore/category/extensions?utm_source=chrome-ntp-icon "web store")で公開されているような拡張機能であり、Chromeユーザーであれば、Last PassやAdblockといったアプリを一度くらいはインストールしてみたことがあるではないでしょうか。これらの拡張機能は基本的にJavascript+HTML+CSSで書かれており、いくつかのExtension固有の技術について学ぶことで、一般的なフロントエンドのウェブアプリケーションで必要とされる技術と同様の技術で開発することができます。

小さなアプリを小さな労力でも作りやすく、公開もデベロッパーとして登録するための5ドル（600円くらい）だけなため、非常に魅力的なChrome Extensionですが、日本語のドキュメントはそこまで多くないため、とりあえず初心者がそれっぽいアプリを作り、公開までを行った軌跡を、Extensionの解説を含めて記事にしたいと思います。
本記事ではタイトルにある通り、このChrome Extensionを使って選択した場所にモザイクをかけられるような拡張機能を作り、~~他人のツイートを晒・・・~~プライバシーに関する情報に対してモザイクをかけたいという問題を解決したいと思います。
また本記事では初心者に向を対象としており、アプリケーションの作成に必要な技術についてChrome Extension固有の技術についても説明します。

またこのアプリはGitHubにてオープンソースでまったり開発を続けており、[MosaicExtension](https://github.com/Uno-Takashi/MosaicExtension)にてアプリのソースをダウンロードすることができます。適宜確認しながらこの記事を読んでいただければ幸いです。使いたいだけの場合は公式ストアから配信しているため、[Web Mosaic - Webストア](https://chrome.google.com/webstore/detail/web-mosaic/fnopjjonmpjaaajonpfmbhfphgbjknpf)からインストールできますのでよろしければぜひ。

## Chrome Extensionの構成

Chrome Extensionは必要なファイルをフォルダにまとめておいてそれを読み込むことでテストすることができます。読み込み方の手順は次の通りです。

* Chromeのメニューから拡張機能を開く
![intro.PNG](https://qiita-image-store.s3.amazonaws.com/0/241757/1600c229-843c-3171-412a-cad62db5782e.png)
* 拡張機能でデベロッパーモードを有効にし、パッケージ化されていない拡張機能を読み込むでファイルを指定する。
![into2.png](https://qiita-image-store.s3.amazonaws.com/0/241757/4e5aefe5-46c7-a04b-9197-ac5092b561fb.png)

この二つでアプリを開いてテストすることができます。
アプリのテストの仕方がわかったところで、Extensionに必要な要素のうち今回のアプリに必要なManifest、Background、Content Scriptの３つについて説明を行います。

### Manifest

ManifestファイルはChrome Extensionに必ず一つ必要なファイルです。Google Extensionではここがフロントエンドの開発と唯一違うところであるといってよく、JSON形式で書かれ、そのアプリの名前、説明、バージョンといった基本的な情報やアプリ持つ権限について記載します。唯一違うところとは言っていますが大して難しいことは書く必要がなく。今回のモザイクアプリの具体的な見ればおおよそ何について記述すればよいかが、わかるかと思います。

```json
{
  "name": "Web Mosaic",
  "description": "ウェブページの選択した部分をモザイクにするためのChrome Extension",
  "version": "0.1",
  "background": {
    "scripts": ["js/background.js"]
  },
  "content_scripts": [
          {
                "matches": ["<all_urls>"],
               "js": ["js/jquery-3.3.1.js","js/spoiler/spoiler.js", "js/content.js"]
          }
     ],
  "permissions": ["contextMenus", "<all_urls>","activeTab"],
  "manifest_version": 2
}
```

Background、ContentScriptsについては後述するとして、今回のアプリに必要な内容としては

- name : アプリの名前
- description : 説明書き
- version : アプリのバージョン
- manifest_version :とりあえず２って書いておけばok
- permission 必要な権限

とこのくらいなものです。より詳細な説明や書き方で困った場合、次の記事を参照してください。
[Chrome 拡張機能のマニフェストファイルの書き方](https://qiita.com/mdstoy/items/9866544e37987337dc79)

## Background Page

Chrome Extensionはバックグラウンドページを持つことができます。このページはHTMLやjavascriptで書くことが出来、ごく普通のウェブページと同様に作ることができます。アプリがインストールされてからバックグランドに常駐し続けるため、[Chrome API](https://developer.chrome.com/extensions/api_index)を使ってイベントの発生を待機したり、バックグランドで処理を回しておくことができます。これがChromeがメモリを占領する原因でもあるわけですが； ；

このバックグランドページの特徴として[Chrome API](https://developer.chrome.com/extensions/api_index)の（おそらく）すべてのAPIにアクセスすることが可能です。Chrome APIは、ダウンロード情報へのアクセス、Chromeのウォールペーパーの変更など、ブラウザの動作に関わる処理を記述することができます。

制限なく自分だけのバックグランドページを作ることができますが、開いているページの関数やDOMにアクセスすることができません。しかし開いているページに処理を実行しろっていうメッセージを送ることができます。

ではバックグランドページの読み込みと確認の仕方について説明します。といってもこれもマニフェストファイルに書くだけです。具体的には上のマニフェストの次の部分に相当します

```json
  "background": {
    "scripts": ["js/background.js"]
  },
```

ここではjsフォルダの下にある`background.js`というJavascriptをバックグラウンドページとして読み込んでいます。もちろんHTMLファイルを読み込むことができます。この読み込んだバックグランドページは拡張機能画面にある「バックグランドページ」からアクセスすることができます。

![backstart.png](https://qiita-image-store.s3.amazonaws.com/0/241757/86369e5b-cd1d-6e02-7860-d958a506054c.png)

例えばbackground.jsに`console.log("Background activate")`とだけ書いていた場合、次のような画面が出てくるはずです。

![backgroundpage.PNG](https://qiita-image-store.s3.amazonaws.com/0/241757/ef479636-26a6-c534-85a0-7236c6d80d17.png)

## Content Scripts

次にContent Scriptsです。Content Scriptsはマッチするすべてのウェブサイトにアクセスした場合に読み込まれます。Content Scriptsは開いているページのDOMや関数にアクセスすることができますが、Chrome APIの一部にアクセスすることができません。CSSをいじってウェブページのデザインを変更する、ウェブページの内容を一部を書き換えるといったことはできますが、「右クリックのメニューにボタンを入れておいて押されたら」や「ページをお気に入りしたら」といったブラウザ上の行動をトリガーにして処理を発動させることができないちょっと惜しい子です。
しかしBackgroundとContent Scriptsはメッセージを送りあうことができるため、Chrome APIに関わることをBackground Pageに行わせ、ウェブページ自体に関わる事はContent Scriptに任せるというのがChrome Extensionの基本的な考え方になります。

今回のアプリの仕様で言えば、「コンテキストメニューにボタンを追加して押されたところを検知する」までがBackground pageのお仕事、「Background pageからメッセージを受け取ったら選択されているところにモザイクをかける」がContent Scriptsのお仕事になります。

Content Scriptsに追加する方法は相も変わらずmanifestファイルに追加するだけです。次は３つのjsを読み込んでいます。

```json
  "content_scripts": [
          {
                "matches": ["<all_urls>"],
               "js": ["js/jquery-3.3.1.js","js/spoiler/spoiler.js", "js/content.js"]
          }
     ],
```

先ほどのManifestファイルの抜粋ですが`"matches": ["<all_urls>"],`だけがBackground pageとちがうところで、これは正規表現にマッチする場合のみContent Scriptsを読み込むのですが`<all_urls>`とすることですべてのURLで読み込まれますgoogleでのみ有効にしたい場合であれば`"matches": ["https://www.google.co.jp/*"],`となります。

# モザイク機能の実装

ここから先が前述の知識を利用してモザイクをかける機能を実装する話になります。まずは基本的な設計について考えておきます。

* Background Page
    * コンテキストメニューへの追加、および押されたときにContent Scriptsに対してメッセージを送信する。
* Content Scripts
    * メッセージの受信、および受信した場合選択されている領域にモザイクをかける処理を行う。

必要な処理はこのくらいなものなので

## Background Pageの実装
バックグランドページの処理は大きく分けて二つに分けられます。

1. コンテキストメニューに項目を追加する。
2. Content Scriptsに処理を開始するメッセージを送信する。

1については[Chrome 拡張機能 ー コンテキストメニュー(ContextType/ItemType）](https://qiita.com/howdy39/items/9ac0564da56246472fc5) を参考に実装を行いました。注意しなくてはいけないのがバックグランドページをイベントページにしてはいけないことです。そうするとこのソースは動かなくなってしまいます。一応解決方法は存在しているらしいですが今回はバックグラウンドページで実装を行います（簡単だから）。

2については[chrome拡張機能 > background.jsからcontentscript.jsにメッセージを送る方法](https://tigawa.github.io/blog/2013/10/13/chrome-extensions-message/)を参考に実装しました(tabs.sendRequestは非推奨になっていますが・・・)。

したがってバックグラウンドページであるbackground.jsは次のようになります。

```javascript
chrome.contextMenus.create({
    "title" : "選択範囲をモザイクで隠す",
    "type"  : "normal",
    "contexts" : ["selection"],
	"onclick": function(info) {
		chrome.tabs.getSelected(null, function(tab) {
			chrome.tabs.sendRequest(tab.id,{});
		});
	}
  });
```

`chrome.contextMenus.create`ではコンテキストメニューに項目を追加することができます。`contexts:["selection"]`とすることで範囲選択した状態での右クリック時にのみ追加されます。

`onclick`はクリック後の動作を表し、ここではタブに対してリクエストを送っています。Content Scripts側ではこのリクエストを受信した場合にモザイク処理を行います。

## Content Scriptsの実装

### リクエストの受信
まずはリクエストの受信です。正直リクエストを受信してしまえばあとはExtensionと関係ないただのjavascriptのDOM操作になるのでそこから先はただのフロント開発になります。とはいっても先ほどの[chrome拡張機能 > background.jsからcontentscript.jsにメッセージを送る方法](https://tigawa.github.io/blog/2013/10/13/chrome-extensions-message/)にContent Script側のプログラムも書いてあるので大したことはありません。

```javascript
chrome.extension.onRequest.addListener(
    function(request, sender, sendResponse) {
        console.log("Mosaic activate");
        // モザイク処理を書く
         }
    }
  );
```

基本は上のソースのように記述すればよく、`//モザイク処理を書く`というところにモザイクにする処理を書けばいいだけです。こうすることで、コンテクストメニューのボタンを押した場合に処理を実行することができます。

### モザイク処理

ここから先はExtensionに関係ない領域ですので簡潔に生きたいと思います。

モザイク処理についてフルスクラッチでプログラムを行うと非常に時間がかかります。そこで今回は[SPOILER ALERT!](https://joshbuddy.github.io/spoiler-alert/)を使おうと思います。このプラグインはwebページにアクセスすればわかりますが、画像や文章にモザイクをかけ、クリックで解除してくれます。使い方も非常に単純で、`spoilerAlert('spoiler, .spoiler');`とすれば、spoilerタグで囲んだ要素、またはspoilerクラスを持つタグにモザイクがかかります。MITライセンスであるため、このプラグインについて「一度モザイクを解除された場合、再びクリックされてもモザイクがかからないようにする」ように仕様変更します。これによって一度モザイクをかけた領域を内包するようにモザイクをかけた場合、「最初のモザイクを再びアクティブにするクリックと、次にかけたモザイクを消すクリックが同時に起こってしまう」という状況にならないような仕様にします。

プラグインに施した細かい変更はソースを見ていただくとして、これで肝心のモザイクをかける処理を（他人の力で）解決しました。便利なプラグインですね

### DOM操作

あとはselectionを使って、DOMをいじって<span class="spoiler"></span>とか適当な感じで囲めばいいのかと思いましたが、二つの問題からうまくいきません。
一つ目の問題はクラス名がバッティングしてしまった場合、`spoilerAlert('.spoiler');`を実行したタイミングですべてのspoilerクラスがモザイクになってしまいます。これは一度モザイクをかけて消した領域なども同様であるため、どこかをモザイクをかけるたびにほかのモザイクがすべて復活してしまいます。もう一つの問題は今回は選択範囲を対象にしているため、spanタグで加工だけだとhtmlの規則違反になる。ということです。具体的な例を次に示します。

```html
<li>...<span class="spoiler">....</li>
<li>.......</li>
<li>...</span>....</li>
```

というような囲い方になってしまう可能性があるという問題です。これはつまり`<li>.....<span class="spoiler">....</li>....</span>`という構造になってしまいHTMLの規則的にアウトになってしまいます。ブラウザはそれでもいい感じに表示はしてくれますが、これが原因となってレイアウトが崩れてしまいます。

この問題はランダムなクラス名にするという方法で一つ目の問題は容易に解決することができますが、二つ目の問題についてはやや解決がめんどさそうだと思い、selection周りを調べていましたが、私の陥っている状況をまさに解決している素晴らしいサイトを見つけてまた他人の力で問題を解決しました。[八章第三回　Rangeの活用とSelection — JavaScript初級者から中級者になろう — uhyohyo.net](https://uhyohyo.net/javascript/8_3.html)に範囲選択した領域を何らかのタグで囲う場合の、非常にわかりやすいサンプルと解説が載っていますのでこちらに解説を投げたいと思います。結果だけ伝えると

```html
<li>...<random-str>....</random-str></li>
<li class="random-str">.......</li>
<li><random-str>...</random-str>....</li>
```

という形で、いい感じにランダムな文字列のタグとランダムな文字列のクラスを用いて囲めるようになりました（まだレイアウトが崩れることがありますが）。これはspoilerAlertでモザイク処理をすることで、一度消したモザイクが復活することなく、それでいてレイアウトを崩すことなくモザイクをかけることに成功しました。

ひとまず、コーディングはここまでとします。

# 公開

とりあえず、作ったアプリを使ってみると選択範囲をいい感じにモザイクにできてるみたいです（ただ一気に選択してモザイクをかけるとまだレイアウトがバグってしまう）。![キャプチャ.PNG](https://qiita-image-store.s3.amazonaws.com/0/241757/2165134f-c0aa-4e1f-3dd5-00404fed9881.png)

とりあえずストアに公開したいと思います。ストアの公開に必要なものはクレジットカードと600円くらいだけですので大した準備は必要ありません。

まずは[Chrome Webストア](https://chrome.google.com/webstore/category/extensions)にアクセスして、歯車マークから「デベロッパー ダッシュボード」をクリックします。![tempsnip.png](https://qiita-image-store.s3.amazonaws.com/0/241757/a2106c86-b567-0e07-acc2-6e448de17435.png)

するとお金を要求されるので「今すぐこの料金を支払う」からクレジットカードを使って払ってしまいます。

![キャプチャ.PNG](https://qiita-image-store.s3.amazonaws.com/0/241757/8d0b457e-e4d7-cb78-d8a8-1731cd26be1a.png)

ここまで行ってしまえばあとは簡単です。新しいアイテムを追加するを押せば、あとはフォームをポチポチ埋めていくだけです。![2.PNG](https://qiita-image-store.s3.amazonaws.com/0/241757/aab5fd5c-3315-32ea-5b60-58852971754c.png)

ただし、この時にいくつか注意点があります

* スクリーンショットなどの画像は指定された大きさでないと受け付けてもらえません
* プロジェクトはマニフェストファイルの入っているフォルダをzipで圧縮してアップロードする

この二点を守れば、あとはさほど難しくはなくひたすら紹介文を書いていけば終わるとひとまずドラフト版が完成すると思います。あとは「公開する」を押してしまえば、ストアに並ぶかどうかの審査が行われ合格すれば晴れてストア入りというわけです。審査はマニフェストファイルで要求している権限によっては時間がかかることがあるようですが、それでも５日程度で公開されます。ちなみに今回作ったアプリも問題なくストアに並びました。

[Web Mosaic - Webストア](https://chrome.google.com/webstore/detail/web-mosaic/fnopjjonmpjaaajonpfmbhfphgbjknpf?authuser=2)

今回の記事はここまでとします。皆様もぜひ何かしらのアプリを作ってみてください。

# 余談

この記事制作を通じて心底面倒だと思った作業にMarkdownのリンク作成があります。

* 「\[]()」←この二つを書いておく
* リンク先のタブに飛んでURLをコピーする
* 戻ってペーストする
* 再びリンク先のタブに飛ぶ
* 今度はHTMLを開いてtitleタグを探してコピーする
* 再び戻ってペースト

これだけの作業をこなさねばならず、タブをたくさん開きっぱなしにしてしまう怠惰な私には非常に面倒な作業だと感じました。
正直できの悪いモザイクアプリなんて作ってないで解決すべき問題はこちらではないかと思いましたので右クリックから簡単にマークダウン形式のリンクを作れるChrome Extensionを作っておきましたｗ
よろしければ記事制作のお役に立ててください。

Github : 
[Uno-Takashi/Markdown-Link-Converter: マークダウン形式に変換したURLとタイトルをクリップボードにコピーするChrome Extension](https://github.com/Uno-Takashi/Markdown-Link-Converter)

ストア : 
申請中

またExtensionはアイデア勝負でいろいろなことができると思います。またJSが多少わかればいいので、中高生向けの講習とかにも向いているかもしれません。それはさておき、この記事を読んだエンジニアがChrome Extensionを作ってくれたらうれしく思います。