﻿『 ページの現在のHTMLをコピー、その他… 』

    ブラウザの拡張機能(Extension)用。
        まだバグや不備多く、注意！。

■ 使用の準備
    Chrome の拡張機能 chrome://extensions/ では、
        デベロッパーモードのスイッチを入れて、
        [パッケージ化されてない拡張機能を読み込む] に、フォルダを指定する。
            必要なら [詳細] で、「シークレット モードでの実行を許可する」や、
              「ファイルの URL へのアクセスを許可する」などにチェックを入れる。
              ローカルでのテストには、「ファイルの…」が必要。
            スイッチで、使用するかどうかを切り替える事が出来る。
        ボタン(アイコン)の常時の表示は、拡張機能アイコンをクリックして、
            ピン(固定)アイコンをクリック。
    
    Firefox での取り入れは、
        「アドオンとテーマ」(拡張機能の管理) about:addons では出来ず、
        「その他のツール」>「リモートデバッグ」>「このFirefox」
            about:debugging#/runtime/this-firefox    にある。
        そこで [一時的なアドオンを読み込む…] に、
            このフォルダ中の manifest.json など一つのファイルを指定する。
            これは Firefox の起動の度に行う必要あり。
        その設定は、そこに無く、拡張機能(の管理) about:addons の
            当該項の右端ボタン […] > [管理] にある。
            「プライベートウィンドウでの実行」はここでチェックする。
    
    取り入れ元のファイルを書き換えた(変更した)場合、
        Popup側の .html や .js なら、Popup を出した時に、すぐ反映されるようである。
            ( Firefox は'21/6月には、読み込まれた拡張機能は、元とは別物かと思われたが、
              8月には、元のファイルの変更が反映されるようになっていた。)
        Content側の .js や manifest.json の変更については、再読み込みのボタンを押す。
            Firefox では「一時的な拡張機能」の当該項に、削除ボタンと並んである。
            Chrome では、chrome://extensions/ を デベロッパーモード に入れて、
                当該箇所にある、廻り矢印のボタンを押す。
        Chromeで、再読み込みの後、既に表示されていたタブ(ページ)では、この拡張機能は、
            ページにアクセス出来なくなっている。chrome.runtime.reload() した場合も。
            タブ(ページ)を更新(F5)すると直る。(多分、ページに絡んでいる Content
            スクリプトが再読み込み前のもので、ページごとやり直す必要がある。)
        ブラウザを(再)起動した時には、Chromeでは一時的な拡張機能も再読み込みされている。
    
    Chromeの拡張機能 chrome://extensions/ のデベロッパーモードにある当該項で、
        [詳細] [削除] の隣に [エラー] とあれば、押すと、エラーの詳細が表示される。
        再読み込み前に、それまでのエラー(の表示)を削除して置くと、再読み込み後に
            エラーがあるか、それがどこかが、すぐ分かる。
            デベロッパーモードにしてあり、[詳細]で「エラーを収集する」となっていれば？。
        
        利用できないページでは、いつもエラーが起きるが、これは問題ない。
            ( ページへアクセスできるかを確認するのに、sendMessage() を使うと、
              応答が無い事が、エラーとなるようで、try-catch で囲んでも、
              エラーを捕捉できない？。)
    
    Chrome の拡張機能の新しい仕様、Manifest version 3 で使うには、
        manifest.json を、フォルダ manifest_v3/ 中の manifest.json と取り換える。
            ( version 2 は、来年'22 には使えなくなる？)
        Manifest V3 では、eval() や new Function() は、Popup側だけでなく、
            contentスクリプト側でも使えなくなった。
            executeScript も、テキストを渡せなくなった。
          その為、動作しない箇所が、幾つか出てくる。
    
    現在のタブ(のページ)が、
        設定などのページ (chrome:～, about:～ など)では、
            ページへのアクセスが許可されず、content script が動作しない。
            popup側の(tabs.)executeScript()も、ページ(content)側への挿入なので、動作しない。
        about:blank (空白のページ) では(ページへのアクセスは)、動作しない。
        ローカルファイル(file://～)では、Chromeは、設定で、
            「ファイルの URL へのアクセスを許可する」にチェックを入れて置く必要あり。
            Firefox は特に設定無く、動作する様。
    
    ほとんどは、Popup で作業しているので、
        Popup が閉じる事をしてしまうと、(書き入れ途中のものが)御破算になってしまう。
        Chrome では、Popup 以外の Chrome をクリックすると、Popup は閉じてしまうが、
            それ以外で(デスクトップの)ウィンドウの切り替えは可能。
        Firefox では、ウィンドウを切り替えると、Popup が閉じてしまうので使いづらい。
    
    拡張機能としてでなく、popup.html を普通にブラウザで開いた場合、
        ほとんどのボタンなどは、動作しないが、
        [Test] の eval などは、自分自身を対象に動作するようにしている。

--------------------------------------------------------------------------------
■ 上部

最上段の幾つかのボタン
    [ReadMe]ボタン:  このファイルを新しいタブで開く。
        Chrome は、text(固定幅)のフォントが(設定は同じサイズなのに)異常に小さい様で、
            読むには多分、ズームを拡大する必要がある。そのページについて、
            拡張機能からアクセスできないようで、どうにもならない？。
    [NewTab]ボタン:  新しいタブを、空白ページ(about:blank)で開く。
    [Blank]ボタン:  現在のタブを、空白ページ(about:blank)に。
    
    最上段左側に、
      !!!!! と現れた時は、Popup側のスクリプトが多分、エラーで動いてない。
      !!! の時は、現在のタブが、アクセス不能である事を示す。
          あるいは、Content側スクリプトが、エラーで動作不能。


[HTML+Srcs]ボタン
    ページの画像やスタイルのファイル·リストと、現在のHTMLを合わせたものをコピーする。
        その(テキスト)コピーを利用するのは、同梱の dl_srcs.hta で、
            それを起動して、そちらで クリップボードを読み取る。
            このテキストの書式は、そのスクリプトに読み取らせる為のもの。
    
    このボタンの下、右揃えで、+┘に続く、チェックボックス群は、これに関する設定である。
    
    URLs: ☑Img ☑Style は、
        リソースファイルのリストの選択であるが、img, style のみ。
        このリストは、テキストの最初の方、HTMLより前に書き入れている。
        他に、☑Img にチェックある時は、
            アイコン <link rel="icon" href=""> も、あれば加えるようにした。
    
    Import: ☑Img ☑Style は、
        画像やスタイルが、HTMLファイルの外のファイルにある場合に、
          それらを、HTMLファイルの中の記述に変更するよう試みる。
        但し、違うホストにあるファイルは (file://も)、その中身を取得できないという
          セキュリティ制限(CrossSite…?)がある為、多くの場合、役に立たない。
    
    Cutdown: ☑iframe ☑object ☑script は、
        チェックのある要素を、実際のページから削除して、その結果の HTMLをコピーする。
    
      ※結果、変更されたページを戻すには、[F5]キーなどで 更新を。
          ( 何のせいか、戻らない事も？。→[Shift]+[F5]などを？)
      ※script要素を削除しても、既に表示のページに対しては何の作用もない様である。
      ※現在のHTMLが、スクリプトが関わって作られたものとしたら、
          その結果の表示を最初からあるようにページを保存した場合、
          そのスクリプトは無用というか問題を起こすのではないか、
          その為、script要素を取り除いて置いた方が良いのではないかと思われる。
      ※同梱の dl_srcs.hta では、 HTMLを書き換えるが、その時、スクリプトは出来る
          限り取り除き、また iframe や object なども無効になるようにしている
          ので、ここのチェックに関わらず、それらは保存できない。

次段にある灰色の領域は、
    ページのHTMLをコピーする時に使用する。
      その時、ここを触るとコピーが失敗すると思われるので、クリックなどしないように。
      
      スクリプトから直接クリップボードへ送る事が出来ないため、
        ここへ文を表示し選択状態にしてから、コピーのコマンドを呼んでいる。
        多分もっとずっと小さな、気付かれないような部分にしても問題ないかと思う。
      最初ここは、TextArea(複数行の入力欄)を使ったのだが、
        CPUの負荷が大きくなるようなので、通常の要素(の white-space: pre)に変更した。

その隣と下のボタン、
    [HTML]ボタン
        現在のHTMLのテキストをコピーする(クリップボードへ送る)。
            一応、html要素の.outerHTML に、文書型宣言を文頭に付け加えた。
        内部のフレーム(windowの中のwindow)のHTMLについては、
            セキュリティ制限でアクセスできないよう(同サイトなら可能)であるし、
                面倒なので、考えない。
            そのフレームを別に開いて、それを保存する他ない。
    
    [Capture]ボタン
        中途放棄、動作不明。 Manifest V3 用のコードは書いてない。
        ページの画像をキャプチャーした、HTMLテキストをコピーする(クリップボードへ送る)。
            それを、エディタなどに貼り付け、HTMLファイルとして保存しようというもの。
                だが、不完全、縦方向のみで、Windowからはみ出た横方向はキャプチャーしてない。
            画像は、img要素の src= に書く data:… のテキスト。
                表示範囲しかキャプチャーできないようなので、スクリプトで次の位置へ
                    スクロールしまたキャプチャーするを繰り返し、複数の img要素にする。
                    最後の重複は要素の位置指定でごまかしている。
                縦方向のみで、横について書く前に、中途放棄した。以下に気付いたので。
        ※Chromeの開発[F12]ツールに、ページ全体の画像キャプチャー機能があった。
            ページの印刷でも、中身は画像と思われるファイル(PDF)に保存できる。

--------------------------------------------------------------------------------
■ 中段部

以上の下にある一列のボタン群は、
    これより下の面(表示)を切り替える。

▼ [ Cutdown ] の面
    Design Mode:
        ページを編集可能にする。[Toggle]ボタンで、編集状態かを切り替える。
    
    Cutdown:
      チェックボックス群は、[Delete]ボタンの作用の選択。
          [Delete]ボタンは、そのチェックある要素(群)を、ページから削除する。
          ※script要素の削除は、現在のページには何の影響もなく？、スクリプトは
              存在し続ける。削除は、現在のHTMLのコピーのためのもの。
      
      Elements:
          入力欄には、タグ名など CSSセレクタで入力する。
          隣の [Delete]ボタンを押すと、その要素群の削除を試みる。
      
      Other delete:
          [Function] 
              window下の [native code]でない、グローバル関数の名前の削除を試みる。
          [Event]
              幾つかのイベントを、(キャプチャ段階の最初の方で捕まえて)、なるべく
                  スクリプトで利用できないようにしてみる。
              イベント名は、content.js の変数 stt_stopEvents_list で指定可能。
                  デフォルトのリストは、stopEvents() 中に。
          [CssAnim]
              CSS の Animation を止めることを試みる。これは動作しないかも(未試用)。
      
      StyleSheets: 
          入力した番号(index)の StyleSheet の無効/有効を、[Toggle]ボタンで切り替える。
              (これは、HTMLテキストを変更しない？)。
              番号は、document.styleSheets[ 数 ] の数字。 * で全てに適用。
          [?] は、入力番号の StyleSheet の無効/有効を表示。
          [List]ボタンは、StyleSheet のリストを表示。
      
      Images
          入力した番号(index)の Img(画像)要素の URL(src属性)を、
              [Delete]ボタンで、消してみる(画像の表示を消してみる)。
              [Undo]ボタンは、消した src を戻す。
              番号は、document.images[ 数 ] の数字。
          [?] は、入力番号の Img(画像)要素の情報を表示。
          [List]ボタンは、Img(画像)要素のリストを表示。
    
    Charset(Encoding): 
        # Cutdown と関係ないが、ここに置く、、
      [Check]ボタンは、ページの文字コード(Charset)を尋ねる。
          下のボタンで内容を書き換えても、これ(document.charset)は、変わらない。
      
      [Rewrite]ボタンは、文字化け修正の試み。
          隣の入力欄に指定した文字コード(Charset)で、ページを表示し直す。
              欄が空の場合、Charset を指定しないが、多分、utf-8 になる。
          
          適切な方法が不明な為、そのページを別にリクエスト・取得して、指定の
              文字コードを適用したテキストで、無理やりタブの内容を上書きする。
          ( リクエストを、Chrome では Popup側で、Firefox では 
              Content側で( content.XMLHttpRequest を使用)、行っている。
              Firefox の Popup側では、permissions の origins に、例えば <all_urls> が
                加わるようにしても何故か、Request が成功しない？。
              Chrome でも、Content側で可能だが、file: だと出来ない。)
          ( Firefox はまだブラウザから、エンコードの変更が可能、
              [Alt](メニューバー)→[表示(V)]→[テキストエンコーディングを修復(C)] )

----------------------------------------------------------------
▼ [ URLs.. ] の面
    src URL List:
        選択欄(Select,ドロップダウンリスト)で、選択した項目(要素群)の、
            HTML外部のリソースファイルのリストを、表示する。
            HTML内部を参照しているものは取り上げない。
            [A href] は、リソースでなく、リンク先一覧である。
    
    oth:
        [Drop link] 
            Chromeの表示しているページの中にリンクを落とすと、新しいタブで
                そのリンク先を開くようだが、これをページの移動にできないかの試し。
                window上部のタブのある辺りまで、アイコンを持っていくのはつらいので。
            特にローカルのHTMLを開く時に、そうあって欲しい(ファイラーのアイコンから)
                のだが、これには、お決まりのセキュリティで適用不能。
            ブラウザ内のリンク(A href="...")のドロップでもとした為、副作用として、
                ページ内のリンクを押してちょっとずらして離すと、移動になってしまう。
            Chromeの設定にありそうだが、調べてない。
        
        Page: [URL] [Title]
            ただ、現在のページの (decodeした)URL または Title を表示するだけ。
    
    URL:
        テキスト欄には、URL を入力する。
        [Open]
            新しいタブで、欄に入力した URL を開く。
        [Download]
            欄に入力した URL (のファイル)を、ダウンロードする。
        [Head]
            HEADメソッドで、HTTP Request し、その Response Headers を
                表示する。( Popupを閉じずに待つ必要あり。)
        
        [decodeURI]
            欄に入力した %エンコードのある URL をデコードする。
        [encodeURI]
            欄に入力した文字列を、URL(%)エンコードする。

----------------------------------------------------------------
▼ [ Test.. ] の面
    複数行入力欄へ入力したテキストについて、
        [Exec]ボタンを押すか、入力欄で [Ctrl]+[Enter]キーを押すと、
            (プルダウンの)選択欄で選択されている項目を実行する。
        項目のほとんどは、現在のタブが対象で、タブにアクセス不能な場合は使用できない。

    [ eval(script) ]
        入力したテキストを、現在(対象)の window で、スクリプトとして実行(eval)する。
            ( 正確には、現在の window の DOM にアクセスできる拡張機能の contentスクリプト
              で、eval する。現在の窓のスクリプトへは、アクセスできないようで、
              window下に現れるスクリプト上の関数などは、content.js側のものである。)
            (※popup.html を拡張機能としてでなく、普通にブラウザで開いた場合は、
                普通にページの中で実行するようにした。)
            実行の結果、返される値を、表示する。
        Manifest V3 では、使えなくなった。
        
        チェックボックス ☑Enum にチェックあるなら、返された値が object のとき、
            そのメンバーを一覧表示する。
            ☑Sort は一覧表示を名前順に並べ替える。
            ☑Group は一覧表示を値の種類別に並べ替える。
          これらのチェックボックスは、[Elment] [Popup Side] などでも使用。
        
        test.js は、これについてのスクリプトなのだが、その中に、ここで使える
            利便的なショートカット的関数を少し置いている。
    
    [ execute code ]
        入力されたテキストを、拡張機能の executeScriptメソッドに渡して実行する。
            エラーだったのかどうかがよく分からない？。
        チェックボックス ☑Enum などは無効。
        Manifest V3 では、使えなくなった。
    
    [ insertCSS ]
        CSSテキストを入力、それを現在の窓に挿入する。拡張機能の insertCSSメソッドを使用。
    
    [ DOM string ]
        文書のオブジェクトの名前を入れれば、その値をこちらで表示する。
            例えば、xxx.yyy とあれば、window['xxx']['yyy'] と実行して値を得る。
                xxx.yyy[0] の書き方も可能。
        他に、xxx.yyy() や xxx.yyy = value も多分、出来るようにした。
            それ以外の演算子は使えない( = も連続は不可)。
            q は document.querySelectorAll に置き換えるので、
                q("～") の ～ には、CSS セレクタを。
        そのページに書かれたスクリプトの関数や変数には、アクセスできない。
            拡張機能の content側の関数や変数は、見える。
    
    [ Elment ]
        入力テキストを要素の名前(id)として、取得を試みる。
        CSSセレクタなら、要素群の最初の要素を取得する。
            idでなくTagNameの指定であったり、空白を含むなどは、セレクタ全体を、
            引用符で括ると、CSSセレクタとして受け取る。
        チェックボックス ☑Enum にチェックあるなら、その要素の属性を一覧する。
    [ Elments ]
        入力テキストをタグ名など要素群の名前(CSSセレクタ)として、取得を試みる。
        空白で区切られていたら、要素群名 属性名 と受け取り、属性値のリストを作る。
            例えば、A href で、リンク先のリスト。
        CSSセレクタが空白など含むなら、引用符で括る事。
        名前[数] となっている場合は、要素群でなく、要素を取得する。
            このとき空白区切りで後続文字列があっても、無視する。
            この場合、☑Enum などのチェックも使用する。
        要素群の名前として、name属性値を指定したい場合、 name:名前 とする。
    
    [ Bit line ]
        整数値のビット列を表現する。( 数でないなら最初の文字のコードを取る。)
            (ビット列は、数値.toString(2) としてもほぼ同じであるが。)
        Manifest V2 でタブにアクセスできる場合や、非extension なら、テキストは 
             eval() するので、ビット演算などの式も可。
        V3 や タブにアクセスできない場合、eval できないので、入力は数字のみを。
    
    [Popup side]
        こちら(Popup)側での、DOMや、スクリプト上の名前を入力する。
            こちら(Popup)側での eval() は禁止されているようで、その代用として、
                DOM 文字列を解釈するスクリプトを書いたが、V3 では、content側も禁止され、
                content側でも、これを使えるようにした→[DOM string]。
            これは、Popup側を調べる。
            但し開発ツール「ポップアップを検証」を使った方が良いかも知れない。

----------------------------------------------------------------
▼ [ Replace ] の面
    クリップボードのテキストを、正規表現で置換する。
        Pattern: の入力欄に正規表現を、その隣にフラグを入力。
        After: は、Pattern の置換された結果となる文字列。
            ここでは、$数 はサブマッチ箇所を参照する。
    
    [Replace] ボタンで、置換を実行する。
        クリップボードのテキストを、小さな領域に取り入れ、置換してクリップボードへ返す。
    
    ☑Store にチェックあれば、
        上の [Replace] を押した時、置換前のテキストを保存しておく。
        また右に別の [Replace] ボタンを表示する。このボタンでは、
            その保存した置換前のテキストから、再び置換しなおす。
    
    →[TextArea] ボタン
        テキスト入力欄(TextArea)を表示し、その中のテキストを置換する。
        [Paste] ボタンで、クリップボードから、入力欄へ、テキストを得る。
        [Copy] ボタンで、入力欄のテキストを、クリップボードへ送る。
        この [Replace] ボタンは、クリップボードのテキストを変更しない。
    
    クリップボードのテキストを直接スクリプトで得る事が出来ず、一旦、HTMLの表示上で
        扱うので、サイズが大きいテキスト(MB)を、取り込む事は、問題あるかも。
    あまり使わないので動作は不明。
    拡張機能でなく、普通に開いた時、コピーや貼り付けは、出来ない。

--------------------------------------------------------------------------------
■ 結果表示部

    [Copy]ボタンは、結果の表示をクリップボードへ送る。(普通に開いた時は動作しない。)
    [C]ボタンは、結果の表示を消す。
    それらの下に、結果を表示する。
    
    Popupを開いた時、結果表示部には、
        そのタブのタイトルと、デコードした URL を表示する。

--------------------------------------------------------------------------------
■ その他
ファイル
    manifest.json
        拡張機能の設定ファイル。Manifest version 2 
    manifest_v3/manifest.json
        Manifest version 3 用。使うには、../manifest.json をこれと置き換える。
    popup.html
        ポップアップの HTML。
    popup.js
        popup.html から呼んでいるスクリプトファイル。html の最後の方で指定している。
    popup_stt.js
        popup.html で、popup.js の直後に指定しているスクリプトファイル。
        特に内容無し。設定用というか、popup.js の一時的修正やテストのためのもの。
    content.js
        content側(対象のページのDOMを操作)のスクリプト。
    content_stt.js
        content.js とともに指定している(manifest.json)。
        特に内容無し。content.js の修正テスト用。
    test.js
        popup側、content側、どちらでも、必要あれば読み込むスクリプト。
        ../dl_srcs/ のHTAでも(自己診断などに)使っていたので、新しい JavaScript
            の構文( let, ()=>{}, .then(), …)などは、入れてない。が、そちらの使う
            test.js は、../test/ へ別に置く事にしたので、その制約は無くなった。
            まだ、不要なコードは削除してない。
    test_content_js.html
        content.js, test.js の構文エラーを確認するためだけの html。

----------------------------------------------------------------
変更
    2022/04/15
        test.js を加筆修正。更に、../dl_srcs/ 等から使う test.js は、コピーして
            別の所に置く事にし、こちらは、拡張機能専用とすることにした。
            それで、IE(HTA)用の無駄なコードが残ったが、それは未だ除いてない。
    2022/03/17
        test.js 中で、名前の先頭に $ が付いてなかった関数の名前を、先頭に $$ が
            付くように変更した。test.js を転用した時、その中の関数かの区別が
            付き易いようにしたかったので。
            この変更の為、関数を呼び出していた popup.js, content.js も変更した。
    2021/10/13
        popup.html の中のスクリプトファイルの指定箇所を、最後の方から、
            head要素の中へ移した。Popup が表示される時、そのサイズが変遷して
            見苦しいのを改善できるかと思ったのだが、違った。最後に置いていたのは、
            button要素の onclick 等を、htmlファイル中に書けない仕様の為で、
            head要素へ移すには、それらを、onload の EventListener の中に…。
    2021/08/16、8/24
        ページの(表示の)文字コードを修正·変更する試みを加えた。
    2021/06/13
        バグ修正を少しと、他各所を修正。 test.js を多く書き換えたが、
            特に DOM文字列の所は、確認不足で、バグを増やしたかも。
          他、[HTML+srcs] の リソースリストで、img にチェックある時、icon も加えた。
    2021/05/12
        Manifest version 3 への対応の為に、executeScript() にコード(テキスト)を
            与えていた所などを修正。(残っている所もあり)。
        表示の構成を変更した。

--------------------------------------------------------------------------------
