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

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

ページの修正とスクリプトレット

同梱のページの修正とスクリプトレットの文法について説明します。Shield AdBlock 1.0.2 は、追加したリストや自分のルールからはこの文法を実行しません。

概要

ページの修正 は、Shield に同梱された小さなヘルパーを使い、限定的に定められたページの動作を変更します。フィルターは対応するヘルパーとその引数を選べますが、Shield にダウンロードさせて実行させる新しい JavaScript コードを渡すことはできません。

ページの修正 のスイッチは、内蔵の修正を制御します。これらの同梱の修正は別の設定のままで、引き続き Shield に同梱されたヘルパーを使います。Shield AdBlock 1.0.2 のパッケージには、Chrome、Edge、Firefox のいずれでも、追加ソースの修正 と、自分で書いたルールのスクリプトレットが含まれていません。詳細設定 で詳細なコントロールを表示できますが、表示しても、含まれていないその段階が追加されるわけではありません。

これらの 1.0.2 パッケージには内蔵の修正が含まれており、追加したリストやカスタムルールのスクリプトレットの段階は含まれていません。内蔵の修正がメインのページで機能していても、ほかのウェブサイトから埋め込まれたコンテンツには影響しないことがあります。

構文

このガイドの例は、フィルターの文法を示したものです。Shield AdBlock 1.0.2 のパッケージでは、追加したリストやカスタムルールのスクリプトレットとして実行されるものではありません。同梱のページの修正は、その設定がオンのとき、引き続きパッケージ内のヘルパーを使います。

次のように、ホストを限定した形式を使います。

news.example##+js(set-constant, adBlockDetected, false)

これは、そのウェブサイトに対して、パッケージに含まれる set-constant ヘルパーを要求します。JavaScript のソースコードでも CSS でもなく、サイトがそのプロパティを使っていることを保証するものでもありません。引数はカンマで区切ります。エスケープしたカンマは文字どおりに扱われ、対になった外側の引用符が 1 組だけ取り除かれます。

現在のヘルパー一覧

このビルドは、次の 10 個の正式名を認識します。引数の数の範囲には、ヘルパー名は含まれません。例は +js(...) 内での呼び出しを示しています。それぞれの前に、news.example## のように、意図して選んだウェブサイトの範囲を付けてください。

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

ヘルパーと別名 目的と引数 例 想定される効果と制限
set-constant; set ドットでつないだプロパティを、許可された値の 1 つに設定します。引数はちょうど 2 個です。 +js(set-constant, adBlockDetected, false) 対応している定数の動作を設定します。任意の文字列、コード、上限のない数値は拒否されます。
abort-current-script; acs, abort-current-inline-script, acis 実行中のスクリプトがプロパティにアクセスしたときに停止します。プロパティと、任意のコンテンツとソースの検索文字列で、引数は 1~3 個です。 +js(abort-current-script, adblock) 一致するスクリプトのアクセスに作用し、ページ上のすべてのスクリプトに作用するわけではありません。検索文字列はリテラルである必要があります。
abort-on-property-read; aopr コードがプロパティを読み取ったときに停止します。引数はちょうど 1 個です。 +js(abort-on-property-read, adblock) 指定したプロパティチェーンに作用します。チェーンは、ドットでつないだシンプルな識別子のパスである必要があります。
abort-on-property-write; aopw コードがプロパティに書き込んだときに停止します。引数はちょうど 1 個です。 +js(abort-on-property-write, antiAdblock.write) そのプロパティチェーンを対象にします。そこに書き込む正当なコードが動かなくなることがあります。
prevent-addEventListener; aeld, addEventListener-defuser 一致するリスナーの登録を防ぎます。イベントとハンドラーのソースのリテラルで、引数はちょうど 2 個です。 +js(prevent-addEventListener, click, antiAdblock) 両方の条件が一致する必要があります。空の条件や ! で、要求全体を無条件にすることはできません。正規表現と、ほかのブロッカーの追加オプションは拒否されます。
prevent-fetch; no-fetch-if ページの一致する fetch を防ぎます。条件と任意のレスポンストークンで、引数は 1~2 個です。 +js(prevent-fetch, url:ads method:POST, emptyObj) 指定したすべてのリテラル条件に一致させ、選んだ空のレスポンスを返します。ブラウザーレベルのすべての種類のリクエストを取り消すわけではありません。
prevent-xhr; no-xhr-if 一致する XMLHttpRequest を防ぎます。条件と任意のレスポンストークンで、引数は 1~2 個です。 +js(prevent-xhr, url:collect method:POST, emptyArr) URL とメソッドの条件を使います。fetch 専用の mode: 条件は拒否されます。
json-prune JSON のプロパティを削除します。削除するパスと任意の必須パスで、引数は 1~2 個です。 +js(json-prune, payload.secret, payload.ready) 必須パスが存在する場合に、一致する JSON 構造からプロパティを削除します。範囲を限定したパス言語であり、任意の JSONPath ではありません。
prevent-window-open; nowoif, no-window-open-if, window.open-defuser 一致する window.open の呼び出しを防ぎます。リテラルの引数は 0~1 個です。 +js(prevent-window-open) 条件がない場合は、対象となる範囲での呼び出しを防ぎます。リテラルの照合では、URL だけでなく、呼び出しの引数をつなげたもの全体を調べることがあります。置き換えと遅延のオプションは拒否されます。
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser 一致するタイマーを防ぎます。任意のコールバックの検索文字列と任意の遅延で、引数は 0~2 個です。 +js(prevent-setTimeout, adRefresh, 1000) コールバックのテキストと指定した遅延に一致させます。遅延は有限の値である必要があります。正規表現の引数と追加オプションは拒否されます。

正式名と別名には、.js の接尾辞を付けることもできます。意図がわかりやすいよう、新しいルールでは正式名を使うことをおすすめします。

引数の制限

プロパティ系のヘルパーは、ドットでつないだ識別子を受け付けます。角かっこの式、関数呼び出し、プロトタイプに到達するチェーンは受け付けません。set-constant は、名前付きの値 undefined、false、true、null、noopFunc、trueFunc、falseFunc、noopPromiseResolve、noopPromiseReject、emptyObj、emptyArr、対応している空の形式、そして −32767 から 32767 までの整数を受け付けます。

リクエスト系のヘルパーは、空白で区切られた、範囲を限定したリテラル条件を受け付けます。フィールド名は url、method、そして fetch の場合のみ mode です。フィールド名のない条件は、URL の部分文字列として扱われます。否定には ! を使えます。すべての条件が一致する必要があります。レスポンストークンは、既定の空のテキスト、emptyStr、emptyObj、emptyArr です。不明なフィールドやレスポンストークンは拒否されます。

JSON の削除では、空白で区切られた、ドットでつないだパスを使います。範囲を限定した各セグメントには、対応している *、[]、[-]、{-} の形式を含められますが、位置と処理量に制限があります。プロトタイプに到達するパスは拒否されます。入れ子の構造と目的の効果を正確に確認していない限り、シンプルな名前付きのパスを使うことをおすすめします。

制限

スクリプトレットの名前が認識されるだけでは、ルールは実行されません。引数の数、引数の文法、ウェブサイトの範囲、スイッチが条件を満たし、さらにパッケージにその段階が含まれている必要があります。Shield AdBlock 1.0.2 のパッケージには、追加したリストやカスタムルールのスクリプトレットが含まれていません。そのため、この文法に合ったルールでも、追加したリストや自分で書いたルールからは実行されません。正規表現の引数、不明な名前、対応していない追加オプションがあると、ルール全体がスキップされます。AdGuard の #%# スクリプトレット構文は、##+js(...) の代わりとしては受け付けられません。

内蔵の修正には、それぞれ独自の適用条件と登録状態があります。設定や登録が成功しても、ヘルパーが実行された、目的の呼び出しを捕捉した、表示されていた広告を削除した、ということにはなりません。YouTube 広告の削除や、ほかのブロッカーのスクリプトレットのすべてのバージョンとの互換性を保証するヘルパーはありません。

例

サイトで特定のヘルパーを無効にするには、スクリプトレットの例外を使います。

news.example#@#+js(set-constant)

名前だけを指定した例外は、一致する範囲でそのヘルパーを無効にします。news.example#@#+js() は、すべてのスクリプトレットを対象にする、より広い例外です。これらはネットワークルールやコスメティックルールを無効にしません。例外も呼び出しと同じくらい慎重に確認し、変更後はウェブサイトを再読み込みしてください。

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