PAC ファイル テスター の使い方

名前は proxy.pac や wpad.dat がよく使われます。ブラウザは URL を開くたびにこの関数を呼び、戻り値の文字列に従って接続します。

function FindProxyForURL(url, host) {
  if (isPlainHostName(host)) return "DIRECT";
  if (dnsDomainIs(host, ".example.com")) return "DIRECT";
  return "PROXY proxy.example.net:8080; DIRECT";
}

• url は URL 全体（例: http://www.example.com/a/b）、host はホスト名だけ（例: www.example.com。小文字で、ポート番号は含まない）
• 戻り値は "DIRECT"（プロキシを通さない）か "PROXY ホスト:ポート"。; で区切って並べると、前のものが使えないときに次のものを使います
• SOCKS ホスト:ポート・HTTPS ホスト:ポート などが使えるブラウザもあります

Firefox・Chromium の実装は、どちらも Netscape の元の実装を引き継いだものです。

PAC の中で eval や new Function は使えません（安全のため禁止しています）。new Date() を直接使うと、評価の設定ではなく端末の時計になります。

1. 紹介ページの「ダウンロード」で pac-tester.html を保存し、ダブルクリックで開きます（「ブラウザで試す」でも同じものが開きます）
2. 左の「PAC ファイル」の欄に PAC を貼り付けます。「開く」で .pac ファイルを選ぶか、画面にドラッグ＆ドロップしても開けます。UTF-8 として読めないファイルは Shift_JIS として読みます
3. 右の「テストする URL」に、確かめたい URL を 1 行に 1 つ書きます。http:// を省くと http として扱います。# で始まる行はメモです。一覧は「.txt を開く」「.txt で保存」で読み書きできます
4. 入力するたびに自動で評価されます（Ctrl+Enter か「評価する」でもすぐ評価します）。「結果」の表に、URL ごとの戻り値が出ます
5. 結果の上の色つきのボタンは、戻り値ごとの件数です。押すとその戻り値の行だけに絞り込みます。文字での絞り込み、「エラー・注意だけ」、「CSV で保存」もできます
6. 「構文・ロジックのチェック」に、見つかった問題が出ます。押すと PAC のその行に移動します
7. 画面が狭いときは、PAC・チェック・URL・結果が縦に並びます。PAC の確認はパソコンでの利用を主に想定しています

評価の設定

• ホスト名と IP アドレスの対応表：DNS の代わりです。dnsResolve・isInNet・isResolvable がこの表を使います。1 行に「ホスト名 IP アドレス」（hosts ファイルと同じ「IP アドレス ホスト名」の順でも可）。*.example.com 10.0.0.1 と書くと、その下のホストすべてに当てはめます
• myIpAddress() が返す IP アドレス：拠点ごとにプロキシを分ける PAC を、拠点の IP アドレスを入れて確かめられます
• 評価に使う日時：weekdayRange・dateRange・timeRange が使う日時と、UTC との時差です。「いまの日時を使う」を外すと、好きな日時で確かめられます
• https の URL は、パスとクエリを除いて渡す：Chrome・Edge などと同じ動きです（既定でオン）

1. 上の「差分モード」を押すと、PAC の欄が「旧 PAC（いまの版）」と「新 PAC（変更後）」の 2 つになります。新 PAC の欄には、はじめは旧 PAC と同じ内容が入ります
2. 旧 PAC に今使っている PAC を、新 PAC に変更後の PAC を入れます（それぞれ「開く」やドラッグ＆ドロップでも入れられます）
3. 同じ URL の一覧で両方を評価し、結果が変わった行だけに色と「変更」の印が付きます。変わった件数は結果の上に出ます。「変わった行だけ」で、変わった行に絞り込めます

戻り値の ; の前後の空白の違いは、変化として数えません。エラーやタイムアウトになった場合は変化として数えます。CSV には旧・新の両方の結果が入ります。

• 全角スペース・全角記号の混入：日本語のコメントを書いたあとに、全角スペースや全角の括弧・引用符がコードに紛れ込むことがあります。全角スペースは JavaScript では空白として通ってしまうので、ブラウザでは気づきにくいミスです。コメントの中は問題なし、文字列の中は「注意」、コードの中は「エラー」として出します
• 括弧・引用符の対応：{ }・( )・[ ] の対応がずれている場所と、閉じていない引用符を、行の番号つきで出します。構文エラーの内容も日本語で出します
• 最後の return 漏れ：どの if にも当てはまらない URL で、関数の最後まで来てしまう書き方です。戻り値が undefined になり、ブラウザによって動きが変わります。最後に return "DIRECT"; などを書きます
• shExpMatch のパターンの誤り：shExpMatch(host, ".example.com")（* の付け忘れで、どのホストにも当たらない）、shExpMatch(host, "http://…")（host にスキームは含まれない）、shExpMatch(url, "http://www.example.com")（url の最後の / が抜けている）、大文字の入ったパターンなど。パターンの一覧も出します
• ルールの隠れ：shExpMatch(host, "*.example.com") の return より後に shExpMatch(host, "www.example.com") を書くと、下のルールには決して届きません。単純な if (shExpMatch(…)) return …; の並び（||・dnsDomainIs・host == "…" を含む）について、上のパターンが下のパターンをすべて含んでいる場合を見つけます。戻り値が同じなら「参考」、違えば「注意」です
• 戻り値の形："PROXY proxy.example.net:8080, DIRECT"（区切りは ;）、"PROXY" だけ、ポート番号の範囲外など
• ヘルパー関数の使い方：isInNet のマスクの書き方、weekdayRange("mon")（小文字）、timeRange(22, 6) など

結果の表と合わせて確かめてください。

• 通信しない：構文を調べるライブラリ（acorn）も含めてすべて 1 つのファイルに入っていて、外部のサーバーには接続しません。ブラウザの仕組み（Content-Security-Policy の connect-src 'none' など）でも、外部からの読み込み・外部への送信を禁止しています
• 隔離して実行：PAC はプログラムなので、他人から受け取った PAC に悪いコードが入っている可能性もあります。そこで PAC は、このページでは実行せず、sandbox 属性を付けた iframe（ページとは別のオリジン）の中で起動した Worker で実行します。PAC のコードからは、このページの画面・保存領域（localStorage など）・同じサイトのほかのツールには触れられません。枠と Worker にも同じ通信の禁止がかかるので、PAC から情報を送り出すこともできません
• 止められる：1 つの URL の評価が 0.2 秒を超えたら、Worker ごと止めて作り直します。無限ループがあっても画面は固まりません。止めた URL は「タイムアウト」と表示し、次の URL に進みます
• 保存しない：貼った PAC とテスト用の URL は、既定ではブラウザにも保存しません（「このブラウザに保存する」をオンにしたときだけ保存します）
• 広告・アクセス解析なし：pac-tester.html には入っていません（広告はこの使い方ページと紹介ページだけです）

• 結果の扱い：このツールは DNS を引かずに対応表を使い、時刻は設定した日時を使います。ブラウザ・OS ごとの PAC の実装の違い（https の URL のパスの扱い、使える関数や記号など）も再現しきれません
• 保存されるデータ：評価の設定は、ホスト名と IP アドレスの対応表、myIpAddress の値、評価に使う日時と時差、https の扱いです
• ファイルの扱い：開いた PAC や URL の一覧はブラウザの中で読むだけで、どこにも送信しません。CSV や URL の一覧の保存はダウンロードとして行います
• 見本：見本の PAC は、架空のドメイン（example.com・example.net・example.org・.example）とプライベート・文書用の IP アドレスだけを使った一般的な例です
• isResolvableEx・dnsResolveEx・myIpAddressEx・isInNetEx・sortIpAddressList などの拡張関数は、呼ぶとエラーになります。対応表や myIpAddress も IPv4 アドレスだけを扱います

pac-tester.html には、次のライブラリをそのまま埋め込んでいます。

ライセンスの全文は、THIRD_PARTY_LICENSES.txt と、pac-tester.html の「ライセンス」ボタンで見られます。