﻿Chrome拡張機能： Request干渉テスト (test_block_req)

まだ実際に使っての試しが不足で、バグなど多い。

ブラウザのリクエストへの介入、、
    chrome.webRequest を使用。
        https://developer.chrome.com/docs/extensions/reference/webRequest/
        https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/API/webRequest
    manifest_version: 2 で、background が、"persistent": true でないと
        動かないので、Chrome(ブラウザ)では、もうすぐ使えなくなる？。


[ Reqest ] の面は、
    ブラウザが、Webへ リクエストする前の処置を設定。
[Response] の面は、
    レスポンス・ヘッダ(Response Headers)受信時の処置を設定。

  URLs: テキスト(複数行)入力欄
      URL の指定。複数は改行区切り。
          パターン指定の * の使用可。例えば、 *://*.hostname.com/*  や  file:///* 
              詳しくは https://developer.chrome.com/extensions/match_patterns
                https://developer.mozilla.org/ja/docs/Mozilla/Add-ons/WebExtensions/Match_patterns
                等を。
          無入力(空のまま)なら、全て(どれでも)とする (パターンの '<all_urls>' に置き換える)。
          
          file: については、Firefox では、webRequest のイベントは無いのか、
                  以下で出来るものはないようである。
              Chrome では、Reqest 前のイベントはあり、その記録や阻止は可能だが、
                  ヘッダーの送受信(Request headers、Response headers)は無い。
      
      [↓]ボタンは、現在のタブの URL を、この欄に入れる。
  
  types: チェック(複数)
      処理対象とするリクエスト対象の限定。どれにもチェック無しなら限定しない。
      ☑main_frame は、タブに表示されるページ。
      ☑sub_frame は、その中に表示される内部フレームのページ。
          これらは、HTML 以外のファイルの場合もある。
            (ダウンロードになる類のものは、どうなるのかは試してない。)
      それ以下の項目 ☑script ☑stylesheet ☑image ☑object ☑xmlhttprequest 
          などは、frame の HTML から(或いはその中の script や stylesheet から)、
          要求されるものであろう。

  Operation: 作業の選択
    [ Reqest ] では、
      ◉Blocking 
          合致するものは、リクエストさせない(中止させる、阻止する)。
          ☑log にチェックあれば、阻止した記録を付ける。
      
      ◉Logging
          それら(合致するリクエスト)の記録を取る。
      
      ◉Log_Headers 
          それら(合致するリクエスト)の request headers を記録する。
      
      ◉Overwrite
          それら(合致するリクエスト)の request headers の一部の値を変更する。
          Overwrite RequestHeaders 入力欄に、
              １行に name: value を指定、(複数は改行区切りで)
                  その name の value を、value に上書きする。
                  -name として、value を書かないなら、その header があれば削除。
              User-Agent: Mozilla/5.0 … … …
              -Cookie: 
          ☑extra は、チェックあれば、
              そのイベントの addListener() の3つ目引数(opt_extraInfoSpec)に、
                "extraHeaders" を加える。そうしないと有効にならないものがある？。
              Firefox には "extraHeaders" は無いらしく、エラーになる。
    
    [Response] では、
      ◉Logging
          それらの Response headers を記録する。
      
      ◉Overwrite
          それらの Response headers の一部の値を変更する。
          Overwrite RequestHeaders 入力欄の入力が必要。
             １行に 名前: 値 と (複数は改行区切り)。
             値 を書かず、名前の直前に - なら、そのヘッダーを削除する。
      
      ◉Charset
          文字エンコードの指定 (URL の指定は必須)。(Response headers の変更の一種)。
          Charset:入力欄に、例えば utf-8 や shift_jis などを入力(必須)。
          ☑log にチェックあれば、記録を付ける。
          ☑extra ('extraHeaders' option) は、
              Chrome では加えないと、効かない？。Firefox には無用(エラーになる)。
          ☑main_frame にチェックあれば、types に何も指定されてない時は、'main_frame' 
              指定とする。types にチェックあるや、こちらにチェックなしは、types を使う。
          [URL↑] ボタンは、現在のタブの URL を URLの入力欄に入れる。
          [Check] ボタンは、現在のタブの Charset を答える。
  
  [Set]ボタンで、それを設定する。
      これらの設定は、記憶するようにはしてないので、この拡張機能を再読み込みすると、
          初期化される。
  
  [Entries]ボタンは、既に設定したものを表示する。
  [Del]ボタンは、最後に設定したものを削除する。
  
  
  Log [Get] ボタンは、記録を取り出す。
      それまでの記録は、これで消去する。
      ☑Copy にチェックあれば、表示せずに、クリップボードに送る。


[Ask..]
    オブジェクト( window や chrome )のプロパティの値を答える。
    切り替え ◉BackGround ◉Content ◉Popup で、何処かを選択。
    [Ask]ボタンで実行。
        Content(ページ側)のみ、☑eval も可能。


最上段のボタン群
    [reload]
        自身を reload する。それまでの設定は、消える。
    [readme]
        このファイルを開く。



