2016/10/07 分

IPv4 PPPoEでは、一日の間で通信速度の変動が激しく、特に00:00～01:30頃と18:30～24:00頃には数百Kbps～10Mbps程度にまで低下している。
一方で、v6プラスで提供されているIPv4 over IPv6 IPoEについては、一日を通して50～90Mbps程度の間であり、PPPoEと比較すると安定な水準にある。

[2016/10/15 追記] 2016/10/07～10/13 一週間分の結果

下記の記事参照。
furyu.hatenablog.com

[2016/11/29 追記] 平日と土日祝日の比較など

下記の記事参照。
furyu.hatenablog.com

環境

条件

• さくらのレンタルサーバ（スタンダード）上に、20MBのファイルを設置
• Web サーバ（CentOS 6.x）上から、wget コマンドにて上記ファイルを10分間隔でダウンロードし、転送速度を記録
  IPv4 over IPv6 IPoE(eth1側)とIPv4 PPPoE(eth0側)とをrouteコマンドでGatewayを変更することにより切り替えている。また、それぞれの測定タイミングは5分ずつずらしている。

注意事項

• さくらのレンタルサーバにおける帯域制限の影響については考慮していない。
  以前のデータ（2015/08/05～11、2015/08/12～18）と比較すると、PPPoEにおいても速度の上限はあがっている（～50Mbps→～90Mbps）ように見えるが、これが、さくら側の帯域制限緩和によるのか、それとも、ISP側の改善結果なのかは不明。

IPv4 PPPoE 対 IPv4 over IPv6 IPoE(v6プラス)比較

• PPPoEは高低の差が大きく、特に夜間には輻輳の影響のためか急激に速度が低下
• IPv6 IPoE(v6プラス)は時間帯による通信速度の変化は小さい

IPv4 PPPoE

• 週間を通じて、夜間（19時頃～25時頃）の通信速度低下が顕著
• 土日や祝日（10/8～10）には、09時頃から急な速度低下が見られる

IPv4 over IPv6 IPoE（v6プラス）

• 時間帯や、休日の影響による差は、現状PPPoE程は見られない

画像が外部参照になってしまう

Word で HTML を読み込み、そのまま形式を Word 文書 (*.docx) として保存しただけだと、画像が外部ファイルへのリンクのままとなってしまう。
文書内に画像を埋め込もうとすると、 Word 上の操作では、

「ファイル」タブ→（右側の「関連ドキュメント」の）「ファイルへのリンクの編集」で、『種類：図』のリンク元ファイルを選択し[リンクの解除]を実施、「☑ 文書に図を保存する」にチェックをして[OK]をクリック

となるような処理を、VBScript 上でも行う必要があった。

Sub EmbedImages

Sub EmbedImages( objDocument )ForEach objShape In objDocument.InlineShapes
        IfNot objShape.LinkFormat IsNothingThen
            objShape.LinkFormat.SavePictureWithDocument =True
            objShape.LinkFormat.BreakLink
        EndIfNextEndSub

※参考：word VBA for save picture in document - Stack Overflow等

ファイル名にタイムスタンプを付けたい

ファイル名で並べたときに、時系列順にしたいという要望があった。
これは、Evernote からエクスポートした際、オプションで「☑作成日(C)」にチェックして、*.html ファイル内に「作成日」等を埋め込み、これをファイル名に反映することで対応。
地味に、Wordの全テキスト取得方法を調べるのに手間取った……
Function EvernoteTimeStamp
ファイルの作成日時・更新日時を変えるようにした方がよかったかも？
→更新日時については変更するようにしてみた（作成日時は変更方法がわからなかった）

タイムスタンプの時刻が一桁のときがある

Evernote からエクスポートした *.html の作成日は、「作成日: 2016/11/19 2:34」のように、時刻が一桁の時があるが、ファイル名に使うなら 0 パディングしたかったので、処理を追加。
Function PadLeft
※参考：まいてっくぶろぐ - 【VBS】文字列が指定桁数に満たない場合、0詰めする関数等

作成日がうまく取得できない（日本語文字列が検索でひっかからない）

"作成日[^\d]*(\d+)/(\d+)/(\d+)[^\d]*(\d+):(\d+)"のような日本語を含む正規表現で検索しようとすると、うまくいかない。
これは、VBScript ファイル (EvernoteHtmlToWord.vbs) を UTF-8 で保存していたため。
ファイル形式を Unicode に変更すると、うまく検索できるようになった。
ファイル形式は Shift JIS でも可。

ファイル名が原因で変換されないファイルがある

ドラッグ＆ドロップで指定したファイルのいくつかが変換されていなかった。
調べてみると、ファイル名に『〜』(U+301C)や『プ』(U+30D5 U+309A)等の文字が含まれる場合には、うまく変換できない模様。
これはどうも、WScript.Arguments からファイル名を取り出した時点ですでに化けてしまっているらしく、<FileSystemObject>.FileExists()が False を返す。

当該ファイルを直接ドラッグ＆ドロップする場合にはうまい解決策が見つからなかったが、それらのファイルが入ったフォルダをドラッグ＆ドロップし、<FileSystemObject>.GetFolder() で取得した Folder オブジェクトのFiles コレクションからパス名(.Path)を取得するようにすると、こちらはうまく処理できる模様。

ドラッグ＆ドロップするファイル数が多すぎると実行できない

ファイルをドラッグ＆ドロップで指定する場合、数が多すぎると「実行できません。引数一覧が長すぎます。」というダイアログが出て、実行できない模様。
VBScript の制限だと思われる。自分の環境では、495ファイル以上でファイルで発生（494ファイルはOK）。これがマジックナンバーなのか、その他の要因があるのかは不明。
この場合は、対象ファイルが入ったフォルダをドラッグ＆ドロップしてやれば、その中に495ファイル以上の *.html があっても、実行可能。

平日

02時～16時頃であれば、PPPoEの方がv6プラスよりも良い結果が出ているため、その時間帯ならPPPoEでも可……？
一般的な会社員にはいささか使いづらい時間帯ではあるが。

土日祝日

03時～08時頃を除き、PPPoEでは速度の低下が著しいため、可能であればv6プラスを使用するのが吉。

新たな問題

• ディスプレイアダプタ(NVIDIA GeForce GT 640M)が、「ビデオ コントローラー（VGA 互換）」となってドライバが入っていない
• ハイバネーション（休止状態）が有効になっていて、hiberfil.sys がディスク容量を圧迫

自動解決

• タスクバーにピン留めしていたアプリが消えたり、再起動で無くなったりといった症状は改善
• MS-Edge の Tampermonkey の上記不具合は解消、普通に動作するように

手動で対応

• Caps → Ctrl は手動で再度設定（Ctrl2capを使用）
• "Microsoft KM-TEST Loopback Adapter"は再インストール
  デバイスマネージャー → 操作(A)→レガシ ハードウェアの追加(L)から入れ直し
• Windows Search は手動で無効化（こちらの記事を参照）
• ディスプレイアダプタは、NVIDIAドライバダウンロードからドライバをダウンロード・インストールして対応
• hiberfil.sys を削除（こちらの記事を参照）

未解決

• タスクバーを2段に引き伸ばした状態での「タスクバーを固定する」はうまく動かないまま（再起動等すると1段に戻ってしまう）

開発（移植）するアドオンの読み込み

Firefox 開発ツール デバッガー（about:debugging#addons、≡→アドオン(Ctrl+Shift+A)→[歯車アイコン]→アドオンをデバッグ(B)）を開き、「☑ アドオンのデバッグを有効化」にチェックを入れて、[一時的なアドオンを読み込む]を押す。

開発対象となる拡張機能（アドオン）の manifest.json を選択して開く。

manifest.json を元にして、当該拡張機能の情報が「一時的な拡張機能」欄に表示される。
ここで、エラーや警告等があれば、適宜修正する。
Quantum の manifest.json のチェックは、Chrome に比べてかなり甘いかも（適当にコメントっぽく書いた行とかでもエラーが出なかったり）。逆に、Chromeに持って行くとエラーが出てしまうことがあるので注意。

バックグラウンドページのデバッグ方法

拡張機能のデバッグリンクをクリック。

「リモートデバッグ接続要求」ダイアログが表示されるので、確認して[OK]を押す。
この手順を省略する方法はあるのかな……？

開いた開発ツールを使ってデバッグを実施。

オプション画面のデバッグ方法

オプション画面をデバッグしようと思って……

コンテキストメニューを開くも、「要素を調査」とか出ない……どうやって開発ツールを開けばよいのか……

……と、Firefox 開発ツール デバッガーの当該拡張機能のところに、マニフェストの URLというリンクがあるので、これをクリックしてみる。

マニフェストがタブに開くので、URLの "/manifest.json"の箇所を……

オプション画面の HTML がある相対パス（例では "/html/options.html"）に書き換えて開く。

すると、無事にオプション画面をタブに読み込むことが出来た。
後は、開発ツール（[F12]、≡→ウェブ開発→開発ツールを表示(Ctrl+Shift+I)）を開いて、デバッグを行うことが出来る。
もっとスマートな方法がありそうな気もする……。

開発者向け設定の有効化

フラグ設定画面（about:flags）を開き、

「開発者向け設定」の「☑ 拡張機能の開発者向け機能を有効にする (これによりデバイスが危険にさらされる可能性があります)」にチェックを入れる。

開発（移植）するアドオンの読み込み

右上にある「…」から、

「拡張機能」を選択すると、[拡張機能の読み込み]というボタンが出来ている。

これを押して、

出てきたダイアログから、開発（移植）しようとする拡張機能の manifest.json が含まれたフォルダを選択する。

マニフェストにエラーがあればその旨表示されるので、適宜修正して再読み込みする。
正常に読み込めたら、

当該拡張機能が表示される（この時点で既に起動されている）。

ここで歯車アイコンをクリックすると、

拡張機能の基本情報と操作用のメニューが表示される。

バックグラウンドページのデバッグ方法

拡張機能操作用メニューから

「検査：バックグラウンド ページ」リンクをクリックすると、

開発者ツールが開き、バックグラウンドページのデバッグを行うことが出来る。

オプション画面のデバッグ方法

右上にある当該拡張機能のアイコンをクリックすると、オプション画面がポップアップする。

適当なところで右クリック（コンテキストメニュー）から、「要素の検査」を選択すると、

開発者ツールが開き、オプション画面のデバッグが行える。

ポップアップから操作するのがやりにくい場合、少し面倒だがタブで開くこともできる。
拡張機能操作用メニューに表示されているIDから、

ms-browser-extension://＜拡張機能のID＞/＜オプション画面(HTML)への、manifest.json があるフォルダからの相対パス＞

のようにして、URL が導かれるので、これをブラウザのアドレス欄に入れることで、オプション画面をタブで開くことが出来る。

manifest.json

最初、次のような警告が出ていた。

Reading manifest: Error processing background.persistent: Event pages are not currently supported. This will run as a persistent background page.
Reading manifest: Error processing options_page: An unexpected property was found in the WebExtension manifest.

上の方は、

,   "background": {"scripts" : ["js/background.js" ]
    ,   "persistent" : true}

の "persistent"オプションに関するもので、現状は Firefox ではサポートされておらず、無視される。動作的には特に問題ないので、このまま。

下の方は、

,   "options_page" : "html/options.html"

に関するもので、エラーとなっているが、このままでもオプションページは開くことが出来る。
現在は、

,   "options_ui" : {"page" : "html/options.html"
    }

という書き方になっているため、こちらに合わせておく。

jQuery

jQuery 読み込み時に、

  Content Security Policy: ページの設定により次のリソースの読み込みをブロックしました: self (“script-src moz-extension://7959b7cd-9bbb-443f-8362-df4673e654f6 'unsafe-eval'”) Source: onfocusin attribute on DIV element.

のようなエラーが出ていた。
どうも、v1.x 系を使用していると発生する模様（使用していたのは、v1.11.3）。
参考：Web Extension: Cannot load jQuery into background page, due to CSP - Development - Mozilla Discourse
これは、v2.x 系にて修正されているらしい。v2.2.4 にしたところ、発生しなくなった。

chrome.app.* は使わない

オプション画面の、拡張機能バージョンを取得する処理でエラーが発生していた。
原因は、chrome.app.getDetails().version を使用していたこと。
代わりに chrome.runtime.getManifest().version を使うことで解決した。
参考： [Where is chrome.app officially documented? - Stack Overflow](https://stackoverflow.com/questions/9167150/where-is-chrome-app-officially-documented)

browser.* ネームスペース対応

これまで chrome.* ネームスペースを使用していたが、今後の流れとしては browser.* ネームスペースを使う方が良さそう。
参考： [Chrome incompatibilities - Mozilla | MDN](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities)

といいつつ、既存のものを全部書き換えるのは煩わしいので、各スクリプトの先頭に

window.chrome = ( ( typeof browser != 'undefined' ) && browser.runtime ) ? browser : chrome;

のような一行を入れておくことでお茶を濁してある。

なお、Firefox Quantum の WebExtensions では、browser と chrome の両方が定義されているが、コンテキストによって微妙に見え方が違う。

バックグラウンドコンテキスト(background)

ユーザーコンテキスト(content_scripts)

アドオン開発者センターにユーザー登録

Firefoxアカウントを未所持の場合、アドオン開発者センターにて、ユーザー登録を行う。

自作アドオンのアップロード準備

当該アドオンの全ファイルを一つの ZIP アーカイブにまとめる（アドオンのパッケージ化）。
この際、manifest.json 及び同一フォルダ内のファイルが一番上の階層になるようにアーカイブすること。

あなたのWebExtensionは次のものを格納したディレクトリです。manifest.jsonとその他の必要なファイル-スクリプト、アイコン、HTMLドキュメント等。あなたはこれらを１つにまとめたzipファイルをAMOにアップロードする必要があります。

ひとつトリッキーなこととして、ZIPファイルはWebExtensionを構成するファイルを含み、ディレクトリに入ってはいません。

WebExtensionを公開する - Mozilla | MDN

At this point your extension will consist of a directory containing a manifest.json and any other files it needs - scripts, icons, HTML documents, and so on. You'll need to zip these into a single file for uploading to AMO.

One trick is that the ZIP file must be a ZIP of the extension's files themselves, not of the containing directory.

Publishing your extension - Mozilla | MDN

OKな例

manifest.json
html/options.html
js/background.js
　:

NGな例

src/manifest.json
src/html/options.html
src/js/background.js
　:

自分の場合、src/manifest.json のように src 以下に全て置いていたため、src フォルダを含む形で ZIP を作っていたところ（実際、Chrome 拡張機能の場合はこれでも問題なくアップロードできる）、AMOにアップロードしようとしたらエラーが出てしまった。

新しいアドオンの登録

アドオン開発者センターの

[新しいアドオンの登録]ボタンを押して、登録を開始する。

配布手段を選択し、[続ける]を押す。
特に理由がなければ、「◉当サイト上で……」で良いと思う。

前の手順で準備した パッケージ（ZIP ファイル）をアップロードすると、アドオンの検証が行われ、結果が表示される。

「検証レポートの詳細を見る」をクリックすると、詳細な検証レポートが開く。

これをチェックし、問題があれば修正する。
eval等を使用しているといった警告はあったが、自作以外のライブラリなこともあり、対応はせずにそのまま。エラーでなければ継続できるらしい。

「アドオンの説明」画面に必要事項を記入・入力し（名前と概要は manifest.json に記載のものが転記されている）、[バージョンを登録]を押して登録する。

登録完了後、[掲載ページを管理]を押すと、

アドオンに関する各種情報を確認・変更できるので、必要に応じて追記や修正を行う。

manifest.json

「マニフェスト解析エラー: 'author'フィールドが見つかりません。」と出たので、author フィールドを追加。

browser.* ネームスペース対応

WebExtensions 用に、予め対応してあった。

PATH の問題

オプション画面にて、chrome.browserAction.setIcon( { path : icon_path } ) を使ってアイコンを変化させる処理を書いてあったところ、MS-Edge ではアイコンが正常に表示されなくなった。
調べてみたところ、どうも、アイコンの PATH の指定が、

• Chrome 拡張機能 / Firefox WebExtensions → 呼び出し元の HTML（オプション画面）からの相対パス
• MS-Edge 拡張機能 → manifest.json のあるフォルダからの相対パス

のように違いがあるようで、場合分けが必要だった。

fetch() や XMLHttpRequest で ArrayBuffer を使用すると未定義のエラーが発生

ユーザーコンテキスト（content_scripts）で fetch() を使用すると、

  SCRIPT65535: 未定義のエラーです。

どうやら、同様の現象が他でも見られるみたい。
Fetch API in Extension SCRIPT65535 error - Microsoft Edge Development
https://developer.microsoft.com/en-us/microsoft-edge/platform/issues/attachment/14192157/8236868/

同様に、XMLHttpRequest で、xhr.responseType を 'arraybuffer'に設定した場合に、xhr.response を参照しようとするとエラーとなってしまう。

  SCRIPT65535: 未定義のエラーです。

いったん、responseType を 'blob'にして受けてやると response は参照できるので、これを ArrayBuffer 化することは可能だった。
ただ、その場合でも、JSZipの アーカイブ処理(JSZip#generateAsync)で失敗してしまう。

よって、MS-Edge の拡張機能では、Twitter 原寸びゅーや Twitter メディアダウンローダで使用している JSZip による ZIP 化が出来ず、ZIP ダウンロード機能が無効化してしまう。
特に、メディアダウンローダの方はほぼすべての機能が使えなくなってしまう……(哀)。

バックグラウンドでのダウンロードができない

バックグラウンドコンテキスト(background)内では、現状、ファイルのダウンロードができない模様。

Overarching issues
The following known issues span across the extension platform and will be fixed in the near future:
: (中略)
・Triggering a download via a hidden anchor tag will fail from background scripts. This should be done from an extension page instead.

Extensions - Supported APIs - Microsoft Edge Development | Microsoft Docs

• browser.downloads API は存在しない（2017/04/11現在のロードマップで、"Under consideration" になっている）
• a タグの download 属性を使ったダウンロードも不可（click()してもダウンロードされない）
• navigator.msSaveOrOpenBlob() 等も使えない
  SCRIPT16386: インターフェイスがサポートされていません
• tabs.create() で新たにタブを開いてそちらでやろうとしても、background から開いた場合には上記の不具合が継承されてしまう

ということで、八方ふさがり。
Twitter 原寸びゅーのコンテキストメニューからの「原寸画像を保存」が実現出来ない。
background から content_scripts 宛に sendMessage() して、そちらで処理ならできるかも？でも面倒くさそう……。

並列処理

複数のファイルを同時並行で取得しながらアーカイブする処理です。
コールバック版（zip_request_legacy.js）の場合

'use strict';

( function () {var zip_request = new ZipRequest(),
// (中略)

zip_request.open();

files.forEach( function ( file ) {var url = file.src || file.href,
        filename = get_filename( url );
    
    console.log( '[start]', url, filename );
    
    zip_request.file( {
        url : url,
        filename : filename,
        zip_options : {
            date : newDate( '2017-01-01' )
        }}, function ( result ) {
        console.log( '[result]', url, filename, result );
    } );
} );

zip_request.generate( 'blob', function ( response ) {
    zip_request.close();
    
    // 以下、Aタグのdownload 属性を使ったダウンロード処理} );

} )();

Promise版（zip_request.js）の場合

'use strict';

( async function () {let zip_request = new ZipRequest(),
// (中略)

await zip_request.open();

await Promise.all(
    files.map( async ( file ) => {let result,
            url = file.src || file.href,
            filename = get_filename( url );
        
        console.log( '[start]', url, filename );
        
        result = await zip_request.file( {
            url : url,
            filename : filename,
            zip_options : {
                date : newDate( '2017-01-01' )
            }} )
        .catch( result => {return result } ); // Promise.all() を停止させないための対策
        
        console.log( '[result]', url, filename, result );
        
        return result;
    } )
);

let response,
    download_link;

response = await zip_request.generate( 'blob' );

await zip_request.close();

// 以下、Aタグのdownload 属性を使ったダウンロード処理} )();

コールバック版のライブラリ内で多少工夫をしていることもあり、並列処理に関しては、一見したところそれ程違いは無いかもしれません。
コールバック版では、例えば file() に対応する応答が background からまだ来ない状態で generate() が呼ばれたとしても、全てのファイルについて結果が返るのを待って background に要求を出すようにしているため、上記の書き方が可能。ただし、close() については、generate() のコールバック後に呼び出す必要あり。

直列処理

ファイルを一つずつ順番に取得しながら（逐次）アーカイブする処理です。
コールバック版（zip_request_legacy.js）の場合

'use strict';

( function () {var zip_request = new ZipRequest(),
// (中略)

zip_request.open( function ( result ) {var file_index = 0;
    
    function zip_files() {if ( files.length <= file_index ) {
            zip_request.generate( 'blob', function ( response ) {
                zip_request.close();
                
                // 以下、Aタグのdownload 属性を使ったダウンロード処理                                } );
            return;
        }var file = files[ file_index ++ ],
            url = file.src || file.href,
            filename = get_filename( url );
        
        console.log( '[start]', url, filename );
        
        zip_request.file( {
            url : url,
            filename : filename,
            zip_options : {
                date : newDate( '2017-01-01' )
            }}, function ( result ) {
            console.log( '[result]', url, filename, result );
            
            zip_files();
        } );
    }
    
    zip_files();
} );

} )();

Promise版（zip_request.js）の場合

'use strict';

( async function () {let zip_request = new ZipRequest(),
// (中略)

await zip_request.open();

for ( let file of files ) {// files.map( async ( file ) => { ... } ) は使えないことに注意// ※ map() では、コールバック関数の戻り値が Promise object になり、直列処理されないlet url = file.src || file.href,
        filename = get_filename( url ),
        result;
    
    console.log( '[start]', url, filename );
    
    result = await zip_request.file( {
        url : url,
        filename : filename,
        zip_options : {
            date : newDate( '2017-01-01' )
        }} )
    .catch( result => {return result } ); // エラーで停止させないための対策
    
    console.log( '[result]', url, filename, result );
}let response,
    download_link;

response = await zip_request.generate( 'blob' );

await zip_request.close();

// 以下、Aタグのdownload 属性を使ったダウンロード処理} )();

こちらは、Promise 版のメリットが出ていると思います。
コールバック版は処理の流れが一見解りにくいのに対し、Promise 版では上から下への自然な流れで解りやすくなっています。

使い方

インストール／更新後に Web 版公式ツイッターを開くと、リツイートされているツイートの下の方に [Re:RT] というボタンがついています。

これをクリックすると、当該ツイートを RT したユーザーのうち、最近行った方々が表示されます。

ユーザーのプロフィールの右側に [↓↑] というボタンが表示されますが、

これをクリックすると、

RT 前後 10 分間のツイート概要が表示されます。
RTした人は、その前後に当該ツイートについて言及していることもよくある、という経験則に基づきます。

オプションとしては、表示するユーザー数を変更できます。

これは、最大 100 ユーザーまでです。
Twitter API の仕様による制限です。

更新の際に無効化されてしまう

上記の機能に関して、拡張機能に新たな権限が追加されています。

0.2.5.200以前バージョンから更新された場合、いったん拡張機能が無効化され、有効化しようとすると、

「近傍ツイート検索」の最新バージョンは、さらに許可が必要なため無効になっています。

のようにメッセージが表示されて、再度有効にするかどうかの確認があります。

[再度有効にする]ボタンを押してください。
上記は Chrome の場合ですが、Firefox の場合にも同様のダイアログが表示されることがありますので、その場合は[更新(U)]ボタンを押してください。

※キャンセルを押してしまった場合などは……
　Google Chrome → 拡張機能の画面 chrome://extensions/ （「≡」（右上のハンバーガーメニュー）→「その他のツール(L)」→「拡張機能(E)」）を開き、「近傍ツイート検索」を探して、「□ 有効にする」のチェックボックスにチェックを入れてください。
　Firefox Quantum → アドオンマネージャー about:addons （[Ctrl]+[Shift]+[A]、「≡」（右上のハンバーガーメニュー）→アドオン）を開き、「近傍ツイート検索」を探して、[有効化]ボタンを押してください。

ここで、Google Chrome の場合には

・twitter.com の全サイト、twitter.com 上にある自分のデータの読み取りと変更

とあるので（特に『変更』と出てしまっているので）不安に思われる方もいらっしゃるようですが、「ユーザーデータには変更を加えてはいません」のでご安心ください。
Firefox Quantum の場合、同様のダイアログでは、「・twitter.com の保存されたデータへのアクセス」という表現になっていると思います。
作者本人がそう言っても不安だ・信用できない、という方は、公開しているソースコードをご覧になるか、使用をお控えください。

これは、今回の機能の中で、「個別ツイートをリツイートした最近のユーザー」の情報を取得するために、新たにアクセス権を追加したためです。
Twitter 側に設定してある本拡張機能用のアクセス権限は、「読み取り専用」（Read-only）としているのですが、

拡張機能には「読み取り専用」という権限はなく、アクセスを許可しようとすると自動的に「読み取りと変更」ということになってしまいます。

なお、上記の権限に関して、実際に使用している Twitter の API は以下の通りです。

POST oauth2/token — Twitter Developers
GET application/rate_limit_status — Twitter Developers
GET statuses/retweets/:id — Twitter Developers

参考

レスポンシブデザインのテーマを作成する際の注意点

デザインCSSに Responsive: yes のコメントを入れるのは、忘れやすいので注意。

Python のエラー……？

Inkscape がデフォルトで出力する SVG ファイル（Inkscape SVG フォーマット）は色々と情報が入っていてサイズが大きいので、これを圧縮する方法を調べていると……

SVGのエクスポート – Inkscape@JP

標準で、『最適化 SVG』というフォーマットがあり、これはかなりサイズが小さくなるっぽい。

で、『名前を付けて保存』メニューから、その出力を試そうとしたら……

The fantastic lxml wrapper for libxml2 is required by inkex.py and therefore this extension. Please download and install the latest version from http://cheeseshop.python.org/pypi/lxml/, or install it through your package manager by a command like: sudo apt-get install python-lxml

Inkscapeは、実行したスクリプトから追加データを受け取りました。スクリプトはエラーを返しませんでしたが、実行結果が意図しないものになっていることを示唆している可能性があります。

というエラーが出てしまい、保存に失敗する。

Inkscape が自分でインストールする Python 2.7 と、別件で既にインストールされていた Python 2.7 と競合しているのかと思って、PYTHONHOME や PYTHONPATH の設定変更や削除、C:\Python27 のリネーム等、いろいろと試してみたが、

Traceback (most recent call last):
  File "C:\Python\Lib\site-packages/site.py", line 73, in <module>
    __boot()
  File "C:\Python\Lib\site-packages/site.py", line 3, in __boot
    import os
ImportError: No module named os

とかいったエラーに変わるだけで、どう設定してもうまくいかない。

結局、いったん Inkscape をアンインストールしたあと、インストール時のコンポーネント選択で、

☑ Python 2.7 のチェックを外してインストールしてみると、上記エラーが出なくなった。

なお、代わりに、自身が構築している Python 2.7 の環境には、いくつかのライブラリを手動でインストールしておく必要があるので、注意が必要。

> python -m pip install lxml numpy scour

デフォルトは mm 単位で、A4 サイズ……？

インストールした Inkscape を起動すると、新規ドキュメントが開くが、デフォルトではこれがサイズの単位が mm で、かつ、A4 サイズになっている。

ドキュメントのプロパティ（ファイル(F)→ドキュメントのプロパティ(D)）はこんな感じ。

この設定ではアイコンを作るのには不便そうなので、Chrome 拡張機能の基本サイズ 96px × 96px にしようと思い、

のように設定。
※変更したのは、

• 『Display units』→ px
• 『カスタムサイズ』→幅(W)：96.0000、高さ(H)：96.0000、単位(N)：px
• 『拡大縮小』→ Scale x：1.00000
• 『Background』→☑ Checkerboard background（チェックを付ける）
• 『境界線』→☑ 描画より前面に境界線を表示する(T)（チェックを付ける）、□ 境界線に影を表示する(S)（チェックを外す）

これで、ドキュメントは

といった感じになる。

ただ、毎回設定するのは大変なので、デフォルトを変えたい。

Setting up page template - InkscapeForum.com

などを参考に、↑のように設定変更したドキュメントを

%UserProfile%\AppData\Roaming\inkscape\templates

の下に、default.ja.svg というファイル名で保存しておく。
すると、新規ドキュメントを開いたときに、上記設定が反映されるようになる。

『最適化 SVG』形式で保存すると……画面いっぱいのアイコンが?!

苦戦しつつもアイコンを描き終わり、『最適化SVG』形式で保存し、これをブラウザで表示してみると……

……でかっ!!

エディタで当該 SVG ファイルを見てみると……

<?xml version="1.0" encoding="UTF-8"?><!-- Created with Inkscape (http://www.inkscape.org/) --><svg version="1.1"viewBox="0 0 96 96"xmlns="http://www.w3.org/2000/svg"xmlns:cc="http://creativecommons.org/ns#"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

viewBox は指定されているものの、width と height が抜けている……？
そこで、SVG タグを

<svg version="1.1"viewBox="0 0 96 96"width="96"height="96"xmlns="http://www.w3.org/2000/svg"xmlns:cc="http://creativecommons.org/ns#"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

のように、「width="96" height="96"」を付け加えたところ、

のようになんとか普通に表示されるようになった。

なお、『Inkscape SVG』形式や、『プレーン SVG』形式の場合には、width・height は入っているため、『最適化 SVG』形式の場合の不具合かもと考えている。
ちなみに、

• 『カスタムサイズ』→幅(W)：25.4000、高さ(H)：25.4000、単位(N)：mm

にしておくと、『最適化 SVG』であっても width・height が入り、

<svg width="25.4mm"height="25.4mm"version="1.1"viewBox="0 0 96 96"xmlns="http://www.w3.org/2000/svg"xmlns:cc="http://creativecommons.org/ns#"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

見た目上の表示もまっとうになる。

他のサイズで出力するには……？

96px × 96px で作成しているが、例えば Chrome 拡張機能用には、48px、96px、128px というサイズのアイコンが必要になる。
しかも、128pxは、96px のアイコンの周囲を 16px の透明ピクセルで囲んだもの。

SVG 形式の場合

<svg version="1.1"viewBox="0 0 96 96"width="96"height="96"xmlns="http://www.w3.org/2000/svg"xmlns:cc="http://creativecommons.org/ns#"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

※ 48px

<svg version="1.1"viewBox="0 0 96 96"width="48"height="48"xmlns="http://www.w3.org/2000/svg"xmlns:cc="http://creativecommons.org/ns#"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

※ 128px（周囲16pxは透明）

<svg version="1.1"viewBox="-16 -16 128 128"width="128"height="128"xmlns="http://www.w3.org/2000/svg"xmlns:cc="http://creativecommons.org/ns#"xmlns:dc="http://purl.org/dc/elements/1.1/"xmlns:osb="http://www.openswatchbook.org/uri/2009/osb"xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">

ちなみに、view Box と width・height の関係は、以下のサイトの解説が分かりやすかった。
old-pine.net

PNG 形式の場合

Chrome 拡張機能版（Google Chrome／Vivaldi／Opera＋Install Chrome Extensions対応）

chrome.google.com

より、[+CHROME に追加] ボタンを押してインストール。
ボタンの名称はブラウザによって異なります（[+（ブラウザ名）に追加]）。

Firefox Quantum アドオン版（WebExtensions）

https://addons.mozilla.org/ja/firefox/addon/amzorderhistoryfilter/addons.mozilla.org

より、ページ上に表示されている [+ Firefox へ追加] ボタンを押してインストール。

ユーザースクリプト（Tampermonkey）版（Firefox/Google Chrome対応）

Firefox＋Tampermonkey、Google Chrome＋Tampermonkeyの環境で、

amzOrderHistoryFilter.user.js：アマゾン注文履歴フィルタ ・ユーザースクリプト版

GitHub - furyutei/amzOrderHistoryFilter: アマゾン(amazon.co.jp)の注文履歴を月別表示したり、月別もしくは通年の領収書をまとめて表示・印刷したりできるようになります。

をクリックし、指示に従ってインストール。

オチ

ChromeもFirefoxも入れてないんですよね…

— 野間美由紀 (@rose_m) 2018年2月5日

Kindle領収書の件、いろいろどうもありがとうございました。すでに「オチ」として追記されてらっしゃる通り、すぐに試すことができませんが（そして印刷も終わってしまったのですが）来年のためにブックマークさせていただきます。年末に骨折して今日やっとメインのMacを使えるようにしたところです。

— 野間美由紀 (@rose_m) 2018年2月6日

作成中にハマった点など

今回も思わぬところでハマりまくりました……。

• 領収書専用のウィンドウを開いて、そこに領収書分だけタブを開き、後で全タブ選択して印刷すればできたりしないか？
  →タブを複数選択しても、印刷されるのは現在表示されているページだけだったのでダメ
• 注文履歴ページを $.ajax() で取得すると、よくわからない(HTMLではない)ファイルが返る
  →リクエストヘッダに X-Requested-With : XMLHttpRequest が含まれると、Amazon から HTML ではない形式で返されてしまう模様
  →crossDomainパラメータをtrueで指定してやるとX-Requested-Withが送られなくなった（参考1、参考2）
• Firefox のアドオン版として動かしたときだけ、$.ajax() によるページ読み込みが失敗する
  →$.ajaxに指定する際、url は相対パスだとだめ（"SyntaxError: The URI is malformed."エラー）
  → new URL() で絶対パスに変換して大丈夫になった
• 注文履歴を取得して表示する際、件数が多いと表示が固まってしまう
  →ブラウザのウィンドウ内で見えない分は非表示にし、スクロールしたときに必要分だけ表示するようにして対応
• 領収書を $.ajax() 等で取得すると、支払情報等の欄が入っていない
  →スクリプトで動的に表示するようになっているらしい
  →裏で(IFRAMEで)開いて、表示が落ち着くまで監視し、落ち着いたら HTML を取得して親ウィンドウに postMessage() で送信することで対応
• 領収書の数が多いと、ブラウザが固まる・応答しなくなる等の現象が発生
  →領収書の数だけIFRAME作っていたので（開きすぎだ）、一定数だけ開き、終わったら使いまわすことで対応
• アイコン作成が面倒
  →面倒だけど、やるしかなかった(苦笑)

その他に気付いたことなど

• 一度でも領収書を表示してしまうと、二度目からは問答無用で「再発行」扱いになるっぽい……（今のところ、デジタル注文の場合、再発行にはならないが）
  試しに表示した、とか、ブラウザが固まった、等の事情が一切考慮されないのが、ちとモヤっとする……
  これ、消したくなるな……普通にテキストだから修正できるんだよね……でもなぁ……

安定性の向上

最初の方の版では、いつまで経っても領収書読み込みが完了しない、という現象が、状況によっては割と頻繁に発生していました。
特に、一度に処理する領収書数が多い方の場合。

ひとつの原因として、領収書の取得を行うには認証状態であることが条件なのですが、読み込み処理中に認証期限が切れてサインインを要求されて（ログインフォームが表示されて）しまい、バックグラウンドで読んでいるページが処理が続けられなくなる、というのがありました。
処理が止まるタイミングは前回のサインインをいつ行ったかに依存するため（期間もかなり短くしてある模様・15分くらい？）、なるべく認証期間を有効に使うために、開始直前にサインインを行うように修正しました。

デメリットとして、領収書印刷用画面を開く毎に必ずサインイン画面が表示されるため、少し煩わしくなってしまいましたが、あと少しのところで固まるよりはマシだと割り切ってくださるよう、お願いします。

領収書読み込み時のカウンタ追加

領収書読み込み中、画面右上に

のようにカウンタが表示されるようになったので、進行状況がすぐわかります。
また、何らかの不具合で固まってしまっても、見ていれば止まっているのが分かるようになりました……（汗）。
一応、一定時間待っても変化が無ければ、ダイアログが表示されて中断できるようにはしています。

絞り込みの際の制限事項

• 標準の [注文を検索] では
  「タイトル」「注文番号」「カテゴリー」「Eメールアドレス」「届け先」
  が対象ですが、アマゾン注文履歴フィルタでは
  「カテゴリー」「Eメールアドレス」
  については対象外となります。
  「届け先」は別途「お届け先」フィルタを組み合わせて指定してください。
• 一件につき五品目以上を注文している場合には、五品目以降が検索にかかりません。

注文履歴 CSV ファイルに配送料、ポイント払い等の情報を追加・Amazonギフト券購入対応

配送料・手数料や、ポイント・ギフト券等による支払いの情報も、注文履歴 CSV ファイル中に含むようにしました。
また、Amazonギフト券購入情報が含まれていなかったので、これを追加しました。

注意

• タブに対するメッセージ送信のために、manifest.json に
  "permissions" : [ "tabs" ]の記述が必要。