UA Pro では、すべてのサイト、特定のドメイン、または個別のタブに対して User-Agent(以下 UA)を設定できます。使用するときは、まずルールが影響するページを選び、次に UA の生成方法を選びます。複数のルールが同時に存在する場合は、拡張機能が優先順位に従ってメインページのルールを 1 つ選びます。通常のページ内リソースは、メインページの UA を優先して引き継ぎます。
01まず UA とページ内リソースを知る
UA は、ブラウザがウェブサイトに送る自己紹介の文字列で、通常はブラウザ、OS、デバイスの情報を含みます。UA Pro は、通常のウェブページへのリクエストに含まれる User-Agent を編集でき、通常のページの navigator.userAgent にも対応する値を返します。
モバイル UA を選ぶと、サイトがモバイル UA に対して返すコンテンツを確認できます。ただし、パソコンがスマートフォンに変わるわけではなく、画面サイズ、ブラウザエンジン、IP、ブラウザフィンガープリント全体が自動的に変わることもありません。
アドレスバーで https://shop.example.com/product を開いているとします。
| 名称 | この例での意味 |
|---|---|
| メインページ | アドレスバーで開いている商品ページ |
| メインページのドメイン | shop.example.com。プロトコルとパスは含みません |
| 親ドメイン | shop.example.com から見ると、example.com が親ドメインです |
| サブドメイン | img.shop.example.com は shop.example.com の下位のサブドメインです |
| ページ内リソース | ページが読み込む画像、スクリプト、スタイル、API リクエスト、通常のネットワーク iframe など |
| リソースドメイン | リソースリクエストの宛先ドメイン。例:cdn.example.net |
本ガイドでいう「メインページのドメイン」は、アドレスバーのページのホスト名を指します。.com のようなトップレベルドメインではなく、example.com のような登録ドメインとも限りません。
023 つの独立した設定概念
| 設定 | 答える疑問 | 例 |
|---|---|---|
| 適用範囲 | どのページがこのルールを使うか | グローバル、example.com ドメイン、現在のタブ |
| UA モード | UA の内容をどこから得るか | 内蔵、カスタム、テキスト追加、ランダム |
| ランダム方式 | ランダムモードを選んだ場合、いつ再抽選するか | ページ読み込みごと、タブごと |
たとえば「ドメイン範囲 + ランダム UA + タブごと」は、そのドメイン範囲内のページを開くタブがそれぞれ、このルールのランダム結果を個別に保持することを意味します。そのドメインにアクセスするすべてのタブが 1 つの UA を永続的に共有するわけではありません。
2.1 適用範囲
| 範囲 | 対象 | 存続期間と上書き関係 |
|---|---|---|
| グローバル | より優先度の高いルールがない通常のウェブページ | 設定は保持されます。ドメインまたはタブのルールで上書きされることがあります |
| ドメイン | メインページのドメインが指定ドメインまたはその下位サブドメインに一致するページ | 設定は保持されます。より具体的なドメインまたはタブのルールで上書きされることがあります |
| タブ | ルール作成時のそのタブ | 優先度が最も高く、そのタブが別のサイトに移動しても引き続き適用されます。タブを閉じると無効になります |
「グローバル範囲 + タブごとのランダム」も、あくまで 1 つのグローバルルールです。ランダム結果をタブごとに保持しても、最優先のタブルールになるわけではありません。
2.2 UA モード
| モード | UA の生成方法 | 主な用途 |
|---|---|---|
| 内蔵 UA | プリセットのブラウザまたはデバイスから UA を 1 つ選ぶ | プリセットの識別情報をすばやく使う |
| カスタム | 入力した完全な UA 文字列を使う | 特定の UA を使う、または独自の UA リストを保存する |
| テキスト追加 | ブラウザ既定の UA の後ろに、スペース 1 つと指定したテキストを付ける | 既定の UA に識別用のマークを付け加える |
| ランダム UA | 選択した候補プールから UA を抽選する | ページ読み込みごと、またはタブごとにランダムな値を割り当てる |
テキスト追加の基準はブラウザ既定の UA であり、上書きされる親ドメインの UA やグローバル UA ではありません。たとえば、グローバルにカスタム UA を設定し、ドメインに MyTest の追加を設定した場合、そのドメインでは最終的に「ブラウザ既定の UA + スペース + MyTest」が使われます。2 つのルールが重ね合わされることはありません。
ランダムの候補プールには、内蔵 UA、カスタムリスト、テキスト追加リスト、またはこれらの組み合わせを使えます。具体的なカテゴリを選ぶこともできます。テキスト追加の候補は、まずブラウザ既定の UA と結合されてから抽選の対象になります。候補プールが空、または有効な内容がない場合、そのルールは有効なメインページのルールになれません。
03メインページのルールの優先順位
タブのルール → 最も具体的な有効ドメインルール → 親ドメインのルール(下位から順に) → グローバルルール → ブラウザ既定の UA。
この順に調べて、有効な UA を生成できる有効化済みのルールのうち、最初に見つかったものを使用します。それより後のルールは組み合わせません。固定モードとランダムモードの間に追加の優先順位はありません。
| 確認順 | メインページが news.shop.example.com の場合の例 |
|---|---|
| 1 | 現在のタブのルール |
| 2 | news.shop.example.com の有効なルール |
| 3 | shop.example.com の有効なルール |
| 4 | example.com の有効なルール |
| 5 | グローバルの有効なルール |
| 6 | 上記のいずれにも有効なルールがない場合は、ブラウザ既定の UA を使用 |
「有効」には 2 つの条件があります。ルールが有効化されていること、そして正当で空でない UA を生成できることです。一時停止中のルール、不正な UA、空のランダム候補プールはスキップされます。
3.1 ドメインの一致方法
example.com を設定した場合、次のメインページに一致します。
| メインページのドメイン | 一致するか |
|---|---|
example.com |
はい |
www.example.com |
はい |
shop.example.com |
はい |
a.shop.example.com |
はい |
otherexample.com |
いいえ |
example.com.other.net |
いいえ |
example.net |
いいえ |
ドメイン欄には example.com のように入力します。https://、パス、クエリパラメータ、ポートは入力しないでください。現在はドメイン単位で設定する方式で、URL のパス単位では設定できません。
1.3.0 には、「そのホスト名のみに一致させ、すべてのサブドメインを除外する」オプションはありません。 shop.example.com の系統だけに影響させたい場合は shop.example.com と入力しますが、その下位のサブドメインも含まれます。
互換用の書き方 *.example.com も、現在のバージョンでは example.com 自体とその下位サブドメインを対象とし、サブドメインだけを対象にするわけではありません。有効な example.com と *.example.com のルールが同時にある場合は前者が優先され、前者を一時停止すると後者が引き継ぎます。新規ユーザーは通常、ふつうのドメイン表記だけを使えば十分です。
3.2 一時停止と削除の違い
| 操作または状態 | 意味 |
|---|---|
| 一時停止 | 設定を保持したまま、一時的にマッチングの対象外にします。再開できます |
| 削除 | そのルールを削除します。必要なときは作成し直します |
| 上書きされた | ルールは有効のままですが、現在のページにはより優先度の高いルールがあります |
| 無効 | 現在の内容では有効な UA を生成できないため、内容または候補プールの修正が必要です |
一時停止または削除すると、拡張機能は他の有効なルールを探し続けます。したがって、一時停止は「このページにブラウザ既定の UA を強制する」除外ルールではありません。
たとえば、グローバルが UA-G、example.com が UA-P、shop.example.com が UA-C の場合は次のとおりです。
| 操作 | shop.example.com を開いたときの結果 |
|---|---|
| 3 つのルールがすべて有効 | UA-C |
| サブドメインのルールを一時停止 | UA-P |
| さらに親ドメインのルールを一時停止 | UA-G |
| さらにグローバルルールを一時停止 | ブラウザ既定の UA |
| 有効なタブのルール UA-T を追加 | そのタブは UA-T を使用 |
ここでの UA-G、UA-P、UA-C、UA-T は、異なる UA の内容を区別するための記号にすぎません。
042 種類のランダム方式
4.1 ページ読み込みごと
メインページを完全にネットワークから読み込むたびに 1 回抽選し、通常のページ内リソースはその読み込みでのメインページの結果を引き継ぎます。再読み込みや完全なナビゲーションでは再抽選されます。画像、API、iframe などのページ内リクエストが、メインページの再抽選を引き起こすことはありません。
たとえば、候補プールに UA-A、UA-B、UA-C が含まれているとします。
| 操作 | 考えられる結果の一例 |
|---|---|
| ページを初めて開く | メインドキュメントと通常のリソースが UA-A を使用 |
| ページが画像や API をさらにリクエストする | 引き続き UA-A を使用 |
| アンカーの切り替えや SPA のページ内ルーティングのみ | 引き続き UA-A を使用 |
| ページを再読み込みする | 再抽選され、UA-C になることがあります |
| このルールに引き続き一致する別のページへ完全に遷移する | 再度抽選され、UA-B になることがあります |
「再抽選」は「必ず異なる値になる」ことを意味しません。ブラウザの戻る・進むでキャッシュ済みのドキュメントがそのまま復元され、メインドキュメントのネットワーク読み込みが再度行われない場合は、新たな抽選とは単純にみなせません。
リダイレクトの場合も、宛先ページに基づいてどのルールが適用されるかを判断します。同じナビゲーションで同じルールが適用される場合、リダイレクトの各段階で繰り返し抽選されることはありません。宛先ドメインが別のルールに一致する場合は、そちらのルールに従って処理されます。
4.2 タブごと
「ルール + タブ」の単位でランダム結果を保持します。設定が変わらず、タブも閉じられていなければ、同じルールのもとでの再読み込みや完全なナビゲーションでも、その結果を引き続き使用します。
たとえば、example.com に「タブごと」のランダムを設定した場合は次のとおりです。
| 操作 | 考えられる結果の一例 |
|---|---|
タブ 1 で example.com を開く |
このルールがタブ 1 に UA-A を割り当てる |
タブ 1 で再読み込みする、またはより具体的なルールがない shop.example.com に移動する |
引き続き UA-A |
タブ 2 で example.com を開く |
タブ 2 の割り当てを保存し、UA-B になることも、UA-A のままになることもあります |
タブ 1 がルールのない other.net に移動し、グローバルルールもない |
ブラウザ既定の UA を使用 |
タブ 1 が example.com に戻る |
そのルールの元の UA-A に戻る |
| タブ 1 を閉じてから開き直す | 元のタブの割り当ては消去され、改めて割り当てられる |
別途 shop.example.com のルールがある場合、2 つのルールが同じ候補プールを選んでいても、それらは別のルールであり、ランダムな割り当てもそれぞれ個別に保存されます。ルールのパラメータや候補ライブラリを編集した場合や、ブラウザを再起動した場合は、ランダム結果が再割り当てされることがあります。
4.3 範囲とモードの組み合わせ表
次の表は、あるルールが優先順位に従ってメインページに適用された後の動作を示します。固定モードには、内蔵、カスタム、テキスト追加が含まれます。
| 範囲 | 固定モード | ページ読み込みごとのランダム | タブごとのランダム |
|---|---|---|---|
| グローバル | 一致するページがそのルールの UA を使用 | メインページのネットワーク読み込みごとに抽選 | 各タブがこのグローバルルールの割り当てを個別に保存 |
| ドメイン | 一致するドメインおよびサブドメインのページがその UA を使用 | 一致範囲内でメインページのネットワーク読み込みごとに抽選 | 各タブがこのドメインルールの割り当てを個別に保存 |
| タブ | このタブが、他のサイトへの移動も含めてその UA を使用 | このタブでメインページのネットワーク読み込みごとに抽選 | このタブではそのルールのランダム結果が固定され、再読み込みやサイト間の移動後も維持 |
どの組み合わせでも、通常のページ内リソースはメインページの UA を優先して引き継ぎます。ランダム方式が決めるのは値の存続期間であり、ルールの優先順位は変わりません。
05ページ内リソースとリソースドメインのフォールバック
5.1 メインページにルールがある場合は、リソースがまず引き継ぐ
次のルールがあるとします。
shop.example.com→ UA-Shop。cdn.example.net→ UA-CDN。
shop.example.com を開き、そのページが cdn.example.net/photo.png を読み込むとき、画像は UA-Shop を使用します。リソースの宛先ドメインに独自のルールがあっても、メインページのルールを上書きすることはありません。これにより、メインドキュメントと通常のページ内リソースが同じ UA に保たれます。
新しいタブのアドレスバーで cdn.example.net を直接開いた場合は、そのドメインがメインページのドメインになるため、自身の UA-CDN ルールに一致する場合があります。
5.2 フォールバックスイッチが働く場面
「その他」にある リソースのドメインルールを許可 は、既定ではオフで、独立したグローバルスイッチです。すべての UA モードに適用されます。
このスイッチは、メインページに有効なタブ、ドメイン、グローバルの UA が 1 つもない場合に限り、リソースが自身の宛先ドメインに基づいて有効なドメインルールを探すことを許可します。リソースドメインでも、「より具体的なルールが優先され、子のルールを一時停止すると親のルールを引き継ぐ」という同じ考え方が使われます。
| メインページに有効な UA があるか | スイッチ | リソース自身が有効なドメインルールに一致するか | 通常のリソースの UA |
|---|---|---|---|
| あり | オフまたはオン | あり、またはなし | メインページの UA を継承 |
| なし | オフ | あり、またはなし | ブラウザ既定の UA |
| なし | オン | あり | リソースドメインのルールで生成された UA を使用 |
| なし | オン | なし | ブラウザ既定の UA |
メインページに有効なルールがない場合、そのメインドキュメントは引き続きブラウザ既定の UA を使用します。リソースのフォールバックが、逆にメインページへ値を設定することはありません。有効なグローバルルールも「メインページに有効な UA がある」状態に含まれるため、グローバルルールがあると、リソースのフォールバックが通常のリソースを引き継ぐことはありません。
5.3 フォールバックの実例
news.example.org を開き、タブのルール、メインページのドメインルール、グローバルルールがいずれもないとします。ほかに cdn.example.net → UA-CDN があります。
| リクエスト | フォールバックがオフ | フォールバックがオン |
|---|---|---|
news.example.org のメインドキュメント |
既定の UA | 既定の UA |
news.example.org/api の API |
既定の UA | 既定の UA |
cdn.example.net/app.js |
既定の UA | UA-CDN |
img.cdn.example.net/photo.png |
既定の UA | UA-CDN(リソースの親ドメインのルールを継承) |
other.net/font.woff(該当するルールなし) |
既定の UA | 既定の UA |
さらにグローバルの UA-G を追加すると、上記の通常のリクエストはすべてメインページの UA-G で統一され、リソースの UA-CDN は適用されなくなります。
5.4 フォールバックとランダムモード
| リソースドメインのルールのモード | フォールバックが許可されている場合の値の決め方 |
|---|---|
| 固定モード | リソースのルールに設定された UA を使用 |
| ページ読み込みごとのランダム | 「ホストページのその回の読み込み + リソースのルール」の単位で結果を保存します。その回の読み込みで同じルールに一致するリソースは結果を共有します |
| タブごとのランダム | 「ホストタブ + リソースのルール」の単位で結果を保存します。同じタブでは再読み込み後も使い続けます |
たとえば、cdn.example.net がランダムモードで、img.cdn.example.net と js.cdn.example.net がどちらもそのルールを継承する場合、両者はその回の割り当てを共有します。img.cdn.example.net に別の有効なルールがある場合は、それは別のルールとなり、別の UA を使用できます。
ほかのタブがリソースドメインにアクセスしても、現在のページですでに保存されているリソースのランダム割り当てが書き換えられることはありません。フォールバックを有効にすると、同じページ内の異なるリソースのルールが異なる UA を使えるようになります。通常のページ全体で UA を一貫させたい場合は、既定のオフのままにするのが一般的です。
06はじめてのルール設定
- 設定したいサイトを開き、ツールバーの UA Pro アイコンをクリックします。
- 「UA ルールを設定」をクリックするか、「その他」から新しいルールを作成します。
- 範囲を選びます。現在のタブだけで一時的に試す場合は「タブ」、同じサイトの複数のタブに適用したい場合は「ドメイン」、すべてのサイトの既定にしたい場合は「すべてのサイト」を選びます。
- ドメインを選んだ場合は、ドメイン入力欄を確認します。たとえば、現在
www.example.comを開いていて、shop.example.comも含めたい場合は、example.comと入力します。 - モードを選びます。内蔵モードではブラウザまたはデバイスを選択し、カスタムでは完全な UA を入力し、追加モードでは追加する内容だけを入力し、ランダムモードでは候補プールとランダム方式を選択します。
- 「確認して適用」で範囲と内容を確認し、「適用」または「保存して適用」をクリックします。ルールのインストール成功の通知を待ちます。
- ウェブページを再読み込みし、ホーム画面に表示される現在有効なルールを確認します。すでに開いているページは、メインドキュメントとスクリプトの両方で新しい UA が使われるように、再読み込みが必要です。
ルール一覧では、ルールを編集、一時停止、再開、削除できます。「上書きされた」は、ルールは保持されているが現在は優先されていないことを、「一時停止中」はマッチングの対象外であることを表します。有効な UA がないという警告が出た場合は、カスタムの内容またはランダムの候補プールを確認してください。
カスタム UA は、単一行の有効なリクエストヘッダーの内容にしてください。改行や制御文字は含められません。新しく作成したカスタムの内容やテキスト追加は、カテゴリ別にリストへ保存でき、後で選択したり、ランダムの候補として利用したりできます。
07目的別の設定例
| 実現したいこと | 設定方法 | 注意事項 |
|---|---|---|
| 現在のタブだけでモバイル UA を試す | タブ + 内蔵のモバイル UA | そのタブで別のサイトに移動しても有効です。タブを閉じると無効になります |
| サイト全体で固定の UA を使う | ドメイン example.com + 内蔵またはカスタム |
すべての下位サブドメインを含みます。ほかのタブにも適用されます |
| ショップのサブサイトだけ別の UA を使う | 親のルールは残したまま、shop.example.com のルールを追加 |
子のルールが優先されます。一時停止すると親のルールに戻ります |
| すべてのサイトで既定の UA を 1 つ使い、特定のサイトだけ例外にする | グローバルに UA-G、対象ドメインに UA-D を設定 | 対象ドメインは UA-D、それ以外のページは UA-G を使用します |
| 特定のサイトで再読み込みのたびにランダムにする | ドメイン + ランダム + ページ読み込みごと | その回の読み込み時のリソースは結果を共有します。同じ値が再び選ばれることもあります |
| 特定のサイトでタブごとに安定させる | ドメイン + ランダム + タブごと | 各ルールの割り当てが、タブごとに個別に保存されます |
| 外部リソースだけを宛先ドメインごとに設定する | リソースドメインのルールを作成し、リソースのフォールバックを有効にする | ホストページに有効なタブ、ドメイン、グローバルの UA があってはいけません |
| サブドメインのルールを一時的に無効にする | 「一時停止」をクリック | 親ドメインまたはグローバルのルールを引き継ぐため、必ずしも既定の UA に戻るとは限りません |
08バックアップと移行
「その他」にあるインポート/エクスポート機能で、グローバルルール、ドメインルール、カスタムライブラリ、テキスト追加ライブラリ、リソースドメインのフォールバックスイッチをバックアップまたは移行できます。
タブのルールと、すでに抽選されたランダムな割り当ては、この永続的な設定のエクスポートに含まれません。インポートしても、元のタブやそのランダムな状態は再現されません。
ローカルの設定ファイルのインポートに加え、リモートの設定アドレスから読み込み、確認したうえでインポートすることもできます。インポートの前にバックアップとしてエクスポートしてください。インポートは設定内容に従って該当する設定を更新するもので、ルールを 1 件ずつ追加する操作として扱わないでください。古い設定にリソースドメインのフォールバックのフィールドがない場合、インポート後このスイッチはオフになります。
旧バージョンのランダム方式 domain は、1.3.0 では「ページが読み込まれるたびに」として扱われます。ランダム方式が明記されていない旧ルールは「タブごと」として扱われます。移行後は、画面で必要なランダム方式を確認してください。
09よくある疑問と使用上の制限
| 疑問 | 説明 |
|---|---|
| 保存したばかりなのに、ページに古い UA が表示されるのはなぜですか? | すでに開いているドキュメントは再読み込みされません。保存の成功を待ってから再読み込みしてください。より優先度の高いルールに上書きされていないかも確認してください |
| 子のルールを一時停止してもカスタム UA が残るのはなぜですか? | 親ドメインまたはグローバルのルールが引き継いで有効になっているためで、これは継承による動作です |
| リソースドメインのルールが効かないのはなぜですか? | まずメインページにすでに有効な UA があるかを確認し、次にリソースのフォールバックが有効かを確認し、最後にリソースドメインのルールが有効かを確認してください |
| 再読み込みしてもランダムな値が変わらないのはなぜですか? | タブごとのモードでは本来値が維持されます。ページ読み込みごとのモードでも、同じ値が抽選されることがあります |
| 同時に開いた新しいタブで UA が同じになるのはなぜですか? | ランダムな値は重複することがあります。また、同時の初回ナビゲーションでは、事前に抽選された同じ予備の値を共用する場合があります |
| モバイル UA に変えても、パソコン向けのページのように見えるのはなぜですか? | サイトが画面サイズ、Client Hints、その他の情報にも依存している場合があり、UA だけを変更してもページのレイアウトが変わるとは限りません |
同時の初回ナビゲーションでは、ブラウザ本来のナビゲーションを維持する方式を採用しています。複数の新しいタブで同時に URL を直接開き、最初のパケットが専用ルールのインストールより先に送られた場合、事前に抽選された同じ UA が使われることがあります。その後は、各タブが割り当てを個別に保存します。この拡張機能はナビゲーションの中継を追加せず、ネイティブのフォーム POST を別のナビゲーション方式に変更することもしません。
通常の HTTP/HTTPS ページとそのリソースが、この機能の主な対象です。共有 Service Worker のリクエストは、1 つのタブに一意に紐付けられるとは限りません。Client Hints、Worker 内の navigator、ネットワークを使わないドキュメントの iframe に対する UA の同期は、このバージョンでは完全には実装されていません。サイト本来の Server-Timing を保持する機能も、今回の変更ではまだ実装されていません。UA の変更を、完全なブラウザフィンガープリントの偽装と捉えないでください。
1.3.0 は、webRequest 権限と webNavigation 権限を使ってメインページのナビゲーションと実際に送信された UA を追跡し、ブロッキングリクエスト権限やデバッガー権限は使用しません。
10バージョンの検証と参考情報
1.3.0 の最終検証環境は、Windows 上の Edge 157.0.4341.42 の分離されたテストプロファイルと、ローカルの HTTP/HTTPS サイトです。HTTPS の全 128 ケース、2527 件のアサーションが成功し、HTTP の境界回帰テスト 5 ケース、441 件のアサーションが成功しました。これらは上記のルールの組み合わせと、説明済みの並行処理の境界を検証したものであり、すべてのブラウザのバージョンやウェブサイトを網羅したことを意味するものではありません。
詳細なテスト記録はプロジェクトの資料として保管されています。インストール可能なバージョンは、Chrome ウェブストアまたはオフラインダウンロードページでご確認ください。提供されているバージョンは、本ガイドの対象バージョンと異なる場合があります。