uBlock Origin フィルター覚書（書き方・サンプル）

はじめに

uBlock Origin (以降uBO) は、「広告ブロッカー」として導入している方がほとんどだと思います。ですが uBO は、広域スペクトルブロッカーです。これは、単なる「広告ブロッカー」としても動作することができる、より強力なブロッカーです。

uBO のフィルターは、UserScript や UserCSS に類するツールの一種であり、フィルターを理解して使用することでより良いウェブ環境を簡易に構築できます。

フィルターの種類

uBOのフィルターには、次の種類があります。

• 静的ネットワークフィルター (static network filtering)
  • 対象リクエスト（通信）をブロックする
  • 書式：[対象URL] + ($ + [オプション])
  • 書式：@@ + [対象URL] + ($ + [オプション])
  • 例：||example.com^
  • 例：@@||example.com^$document
• 静的拡張フィルタリング (static extended filtering)
  • 対象URLの要素をCSS・JavaScript・コード削除で対処する
  • 書式：[ドメイン名（ホスト名）] + ## + [設定]
  • 書式：[ドメイン名（ホスト名）] + #@# + [設定]
  • 例：example.com##h1
  • 例：example.com,example.net#@#h1

コメント - 共通

サンプル

! コメント

!#if false
ブロックコメント
!#endif

静的ネットワークフィルター (static network filtering)

書式

• [対象URL] + ($ + [オプション])
  • 適用
• @@ + [対象URL] + ($ + [オプション])
  • 例外（適用を打ち消す）

※[対象URL]は、static extended filtering の[ドメイン名]とは大きく異なります。
※[対象URL]は、||（domain name anchor）でドメイン名を指定できます。
※[対象URL]は、ドメイン名だけでなく、URLを指定できます。
※[対象URL]は、*（ワイルドカード）を使用できます。
※[対象URL]は、複数のURLを指定することはできません。
※[オプション]には、カンマ（,）区切りで複数のオプションを設定できます。

主な記号の意味

オプション

リクエストを制限する

ドメインで制限する

Content-Security-Policy を設定する

リダイレクトを設定する

※空のリダイレクトリソース

例外フィルター用のオプション

その他のオプション

サンプル

! 例：ドメイン単位の指定
||example.com^
||192.168.1.1^

! 例：例外ルール
@@||example.net^

! 例：すべてのURL
! すべてのサードパーティリクエストをブロックする
*$third-party
*$script
*$script,inline-script

! 例：ファイル名
^example.html^
^example.js^

! 例：URLの指定
http://example.com^
https://example.com/^
https://example.com/test.html^$document
! ※トップページ以外のページは、オプションを明示的に指定する必要があります

! 例：HOSTSファイル
example.com


! 例：ページリクエストを制限する
||example.com^$document

! 例：サードパーティリクエストを制限する
||example.com^$third-party

! 例：スクリプトとインラインスクリプトを制限する
||example.com^$script,inline-script

! 例：ワーカーをCSPを介して制限する
||example.com^$csp=worker-src 'none'

静的拡張フィルタリング (static extended filtering)

書式

• [ドメイン名（ホスト名）] + ## + [指定]
  • 適用
• [ドメイン名（ホスト名）] + #@# + [指定]
  • 例外（適用を打ち消す）

※[ドメイン名]は、static network filtering の[対象URL]とは大きく異なります。
※[ドメイン名]は、URL（特定のページだけ）を指定することはできません。
※[ドメイン名]は、カンマ（,）区切りで複数指定できます。
※[ドメイン名]は、一部の機能を除いて*（ワイルドカード）を使用できます。
※[ドメイン名]は、サブドメインを省略でき、サブドメインにも適用されます。
※[指定]には、[CSSセレクタ]/[化粧品フィルター]/[アクション演算子]/[スクリプトレットインジェクション]を指定できます。

主な記号の意味

※要素非表示は、対象要素に「display: none !important;」のCSSを適用します。
※HTMLフィルターは、対象要素をブラウザ解析前にドキュメントから要素を削除します。
　ブラウザ解析後、動的に要素を作成した場合、要素は削除されません。
※スクリプト挿入は、特定のJavaScriptコードをページに挿入します。
　自由なJavaScriptを挿入できるわけではありません。
　挿入可能なコードは、リソースライブラリ から確認できます。

サンプル

! 例：要素非表示
example.com##h1

! 例：要素非表示の例外
example.com#@#h1

! 例：CSS セレクタを指定する
example.com###target
example.com##.target
example.com###parent .target

! 例：HTMLフィルター
example.com##^h1
example.com##^#target
example.com##^.target

! 例：コスメティックフィルター
example.com##body > div:has-text(Sponsored)
strikeout.me##body > div:has(img[alt="AdBlock Alert"])

! 例：スクリプトレットインジェクション
example.com##+js(noeval)

広告ブロック以外の使用例

! Google検索結果から、特定サイトを除外
www.google.com,www.google.co.jp###search .g:has(a[href*="://example.com/"])

! スクリプトの実行阻止
||example.com^$script,inline-script

! ワーカーの実行阻止
||example.com^$csp=worker-src 'none'

! サードパーティリクエストの制限
||example.com^$third-party

! 個別要素の非表示
!   ポップアップ全般
!   GDPR関連
! Twitterのプロモーションを非表示
! 特定サイトへのリンクを非表示
! コピペガードの無効化
! アンチAdBlocker対策

備考

uBlocklist

Google検索結果から、特定サイトを除外する専用の拡張機能もあります。

※Bing/DuckDuckGoなどの他検索エンジンも合わせてブロックできます。

• iorate/uBlacklist - GitHub
• uBlacklist - Chrome ウェブストア
• uBlacklist – 🦊 Firefox (ja) 向け拡張機能を入手

公式な解説ページ（英語）

• Static filter syntax · gorhill/uBlock Wiki
• How to write filters | Adblock Plus Help Center
• Adblock Plus filters explained

他の解説ページ

• uBlock Origin/Adblock Plus 用フィルタの書き方まとめチートシート - Qiita
• uBlock Origin 再び ＠Firefox - おまえ、うまそうだな
• uBlock Origin の使い方 – Site-Builder.wiki
• Adblock Plusアドオンの自作フィルターのすすめ: 雨鯨のたそがれ