このページは翻訳です。内容に相違がある場合は英語版が優先されます。

上級者向けリファレンス · 上級者向け

ネットワークフィルターの構文

検証済みのネットワークルールのサブセットを使い、例外、範囲、拒否される行について理解します。

概要

Shield は、多くのブロックリストで共通して使われるフィルター言語のうち、範囲を限定したサブセットを受け付けます。正確に表現できない行はスキップします。行を通すために見慣れないオプションを削除すると、意味が変わることがあります。代わりにプレビューを確認してください。

以下の例では、予約済みの例示用ドメインを使っています。これはルールの動作を説明するもので、実際のサービスのためにインストールすべきルールではありません。自分のルールには 1 行ずつ追加し、範囲を確認してから、意図した変更だけを適用してください。

構文

URL パターン

表全体を見るには横にスクロールしてください。

目的 構文と例 想定される効果と制限
ホストに一致させる ||ads.example^ ホスト名の境界で、そのホストとサブドメインに一致します。notads.example には一致しません。種類を指定しないルールは通常のリクエストが対象で、トップレベルのページ移動は対象外です。
URL を固定する |https://cdn.example/ads.js| URL がその位置で始まり、終わることを条件にします。スキーム、パス、クエリが変わると一致しなくなることがあります。
URL の一部に一致させる /ad/image/*$image 指定したパスの後に可変のテキストが続く、画像リクエストの URL に一致します。末尾のワイルドカードにより、スラッシュで囲んだ正規表現と区別されます。
ワイルドカードを使う ||cdn.example/ads/* * は可変のテキストに、^ は区切り文字または URL の末尾に一致します。複数のワイルドカードを含むパターンには、受け付けと処理量の上限があります。任意の大きさのパターンは受け付けられません。

パターンには ASCII の URL テキストを使います。#fragment は含めないでください。ブラウザーは URL のフラグメントをネットワークリクエストの一部として送信しません。

種類、ファーストパーティ/サードパーティ、ウェブサイトの範囲

表全体を見るには横にスクロールしてください。

目的 例 想定される効果と制限
リクエストの種類を限定する ||ads.example^$script スクリプトに適用されます。ほかの種類には image、stylesheet、font、media、object、xmlhttprequest、subdocument、document、ping、websocket、other があります。別名には css、xhr、frame、doc があります。
種類を除外する ||ads.example^$~image 画像を除外します。否定だけのルールでもトップレベルのドキュメントは除外されたままで、ページをブロックするルールにはなりません。
すべての種類を含める ||ads.example^$all トップレベルのドキュメントを明示的に含めます。$all,~script は、それ以外のモデル化された種類を含めます。慎重に使ってください。
ファーストパーティ/サードパーティを限定する ||ads.example^$third-party リクエストが、それを開始したサイトから見てサードパーティの場合に適用されます。3p は別名です。first-party、1p、~third-party、~3p はファーストパーティを選択します。
リクエスト元のウェブサイトを限定する ||ads.example^$domain=news.example そのホストが開始したリクエストだけに一致を限定します。除外するリクエスト元ホストは、下の例のように追加できます。ネットワークの $domain= 範囲でのエンティティのワイルドカードは拒否されます。

含める/除外する範囲では、ホスト名の間に | を、除外するホストの前に ~ を使います。

||ads.example^$domain=news.example|~pay.news.example

例外と優先順位

@@||ads.example^$script,domain=shop.example は、指定したウェブサイトが開始した、一致するスクリプトリクエストを許可します。そのウェブサイトでの保護全体を一時停止するものではありません。

一致する通常の例外は、通常のブロックより優先されます。$important 付きのブロックは通常の例外より優先され、$important 付きの例外はその重要なブロックより優先されます。より具体的に見えるテキストだからといって、優先されるわけではありません。

ページ全体の例外では、@@||shop.example^$document が、一致するトップレベルのページとその読み込みに対する保護を無効にします。この形式には、ファーストパーティ/サードパーティの条件、リクエスト元ドメインの範囲、追加のリソースの種類、$all を付けられません。例外ではない $document はトップレベルのドキュメントのブロックであり、一時停止ではありません。

@@||news.example^$generichide は、そのホストでの汎用的なコスメティック非表示を止めます。サイト固有のコスメティックルールとリクエストのブロックは引き続き使えます。受け付けられるのは純粋なホストアンカーに対する例外だけです。パス、ファーストパーティ/サードパーティの条件、そのほかの種類の範囲は、このホスト専用の形式には引き継がれません。

||popups.example^$popup は、Shield のポップアップ処理を使って、ポップアップの移動先に一致させます。@@||accounts.example^$popup,domain=shop.example は、範囲を限定したポップアップの例外です。これらはスクリプトリクエストのルールではなく、ブラウザー内蔵のポップアップブロッカーを設定するものでもありません。

$popup を、リクエストの種類、$all、$generichide、リダイレクトの操作と組み合わせないでください。1 行で両方の範囲を表すことはできません。ログイン用ウィンドウの問題は、まずログイン画面や支払い画面を確認してください。

hosts ファイルと条件付きブロック

シンクアドレス 0.0.0.0、127.0.0.1、::1、::、0 を使う標準的な hosts エントリは、ホストアンカーのルールに変換されます。たとえば、0.0.0.0 ads.example は ||ads.example^ と同等になります。空白で区切られたそのほかのネットワーク形式は拒否されます。

リストでは、!#if、!#else、!#endif を入れ子にして、!、&&、||、かっこと組み合わせて使えます。条件は Shield のパッケージの対象に合わせて評価されます。真と認識される共通の条件には true、env_mv3、cap_user_stylesheet があり、env_chromium と env_firefox は対象によって変わります。不明な定数は偽と評価されます。これらのディレクティブはリストの分岐を選ぶもので、表示中のページの状態を判定するものではありません。

無害なリダイレクト

受け付けるリソースは決まったものだけです。redirect=noopjs または redirect=noop.js は空のスクリプトを、redirect=nooptext または redirect=noop.txt は空のテキストを、redirect=noopjson は {} を返します。たとえば、||ads.example/tracker.js$script,redirect=noopjs は、このルールが優先されたときにスクリプトを無害なものに置き換えます。

これらはパッケージに含まれた置き換えであり、任意の URL へのリダイレクトや、サードパーティのライブラリの完全なエミュレーションではありません。不明なリソース名と、例外ルールでのリダイレクトの操作は拒否されます。同じ優先順位で競合する完全なブロックが、リダイレクトより優先されることがあります。

制限

正規表現のネットワークフィルター、removeparam、csp、badfilter、redirect-rule、不明な修飾子は、行全体が拒否されます。このリファレンスは、EasyList、uBlock Origin、AdGuard のすべての機能との互換性を約束するものではありません。ここに載っていない構文が、テストのうえで拒否されたとは限りません。

受け付けられたルールでも、ブラウザーの容量を超えたり、保護の設定や例外によって上書きされたりすることがあります。プレビューと保護の状態を確認してください。ルールを設定しても、ページに効果があるとは限りません。

例

対象を絞ったブロックと例外の組み合わせ:

||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example

1 行目は、一致するサードパーティのスクリプトをブロックします。2 行目は、checkout.example が開始した、一致するスクリプトリクエストを許可します。再読み込みした後、ウェブサイトの実際の操作の流れを試してください。リクエストを許可すると、広告やトラッキングも通ることがあります。

解決しない場合は、サポートにお問い合わせください