Referensi lanjutan · Lanjutan
Sintaks filter jaringan
Gunakan subset aturan jaringan yang terverifikasi dan pahami pengecualian, cakupan, serta baris yang ditolak.
Ringkasan
Shield menerima subset terbatas dari bahasa filter yang dipakai bersama oleh banyak daftar pemblokiran. Shield melewati baris yang tidak dapat direpresentasikannya secara akurat. Menghapus opsi yang tidak dikenal agar baris lolos dapat mengubah maknanya; sebagai gantinya, baca pratinjaunya.
Contoh di bawah menggunakan domain contoh yang dicadangkan. Contoh ini menjelaskan perilaku aturan, bukan aturan yang perlu Anda pasang untuk layanan sungguhan. Masukkan satu baris setiap kali di Aturan Anda, tinjau cakupannya, lalu terapkan hanya perubahan yang Anda maksud.
Sintaks
Pola URL
Geser ke samping untuk membaca seluruh tabel.
| Tujuan | Sintaks dan contoh | Efek yang diharapkan dan batasan |
|---|---|---|
| Mencocokkan host | ||ads.example^ |
Cocok dengan host tersebut dan subdomainnya pada batas nama host; tidak cocok dengan notads.example. Aturan tanpa tipe menargetkan permintaan biasa, bukan navigasi halaman utama. |
| Menambatkan URL | |https://cdn.example/ads.js| |
Mengharuskan URL diawali dan diakhiri tepat di posisi tersebut. Perubahan skema, jalur, atau kueri dapat menghentikan kecocokan. |
| Mencocokkan bagian URL | /ad/image/*$image |
Cocok dengan URL permintaan gambar yang berisi jalur tersebut diikuti teks variabel. Wildcard di akhir membedakannya dari ekspresi reguler yang diapit garis miring. |
| Menggunakan wildcard | ||cdn.example/ads/* |
* cocok dengan teks variabel; ^ cocok dengan pemisah atau akhir URL. Pola dengan beberapa wildcard memiliki batas penerimaan dan pemrosesan; pola berukuran sembarang tidak diterima. |
Pola menggunakan teks URL ASCII. Jangan sertakan #fragment: browser tidak mengirim fragmen URL sebagai bagian dari permintaan jaringan.
Tipe, pihak, dan cakupan situs web
Geser ke samping untuk membaca seluruh tabel.
| Tujuan | Contoh | Efek yang diharapkan dan batasan |
|---|---|---|
| Membatasi tipe permintaan | ||ads.example^$script |
Berlaku untuk skrip. Tipe lainnya meliputi image, stylesheet, font, media, object, xmlhttprequest, subdocument, document, ping, websocket, dan other. Alias meliputi css, xhr, frame, dan doc. |
| Mengecualikan tipe | ||ads.example^$~image |
Mengecualikan gambar. Aturan yang hanya berisi negasi tetap mengecualikan dokumen utama; aturan ini tidak berubah menjadi aturan pemblokiran halaman. |
| Menyertakan semua tipe | ||ads.example^$all |
Secara eksplisit menyertakan dokumen utama. $all,~script menyertakan tipe lain yang dimodelkan. Gunakan dengan hati-hati. |
| Membatasi pihak | ||ads.example^$third-party |
Berlaku jika permintaan berasal dari pihak ketiga relatif terhadap situs yang memulainya. 3p adalah alias; first-party, 1p, ~third-party, dan ~3p memilih pihak pertama. |
| Membatasi situs web pemicu | ||ads.example^$domain=news.example |
Membatasi kecocokan pada permintaan yang dimulai oleh host tersebut. Host pemicu yang dikecualikan dapat ditambahkan seperti di bawah. Wildcard entitas dalam cakupan jaringan $domain= ditolak. |
Cakupan sertakan/kecualikan menggunakan | di antara nama host dan ~ sebelum host yang dikecualikan:
||ads.example^$domain=news.example|~pay.news.example
Pengecualian dan prioritas
@@||ads.example^$script,domain=shop.example mengizinkan permintaan skrip yang cocok dan dimulai oleh situs web yang disebutkan. Aturan ini tidak menjeda seluruh perlindungan di situs web tersebut.
Pengecualian biasa yang cocok mengalahkan blokir biasa. Blokir $important mengalahkan pengecualian biasa; pengecualian yang membawa $important mengalahkan blokir penting tersebut. Teks yang terlihat lebih spesifik bukanlah sistem prioritas umum.
Untuk pengecualian seluruh halaman, @@||shop.example^$document menonaktifkan perlindungan untuk halaman utama yang cocok beserta muatannya. Bentuk ini tidak dapat menambahkan kondisi pihak, cakupan domain pemicu, tipe sumber daya tambahan, atau $all. $document yang bukan pengecualian adalah blokir dokumen utama, bukan jeda.
@@||news.example^$generichide menghentikan penyembunyian kosmetik umum di host tersebut. Aturan kosmetik khusus situs dan pemblokiran permintaan tetap berlaku. Hanya pengecualian pada jangkar host murni yang diterima; jalur, kondisi pihak, dan cakupan tipe lainnya tidak terbawa ke bentuk khusus host ini.
Tujuan popup
||popups.example^$popup mencocokkan tujuan navigasi popup menggunakan penangan popup Shield. @@||accounts.example^$popup,domain=shop.example adalah pengecualian popup dengan cakupan tertentu. Ini bukan aturan permintaan skrip dan tidak mengonfigurasi pemblokir popup bawaan browser.
Jangan menggabungkan $popup dengan tipe permintaan, $all, $generichide, atau tindakan pengalihan: satu baris tidak dapat merepresentasikan kedua cakupan itu. Untuk masalah jendela masuk, mulailah dengan jendela masuk dan pembayaran.
File hosts dan blok bersyarat
Entri hosts kanonis yang menggunakan alamat pembuangan 0.0.0.0, 127.0.0.1, ::1, ::, atau 0 diterjemahkan menjadi aturan jangkar host. Misalnya, 0.0.0.0 ads.example menjadi setara dengan ||ads.example^. Bentuk jaringan lain yang dipisahkan spasi ditolak.
Daftar dapat menggunakan !#if, !#else, dan !#endif bertingkat dengan !, &&, ||, dan tanda kurung. Kondisi dievaluasi untuk target paket Shield. Kondisi bersama yang dikenali bernilai benar meliputi true, env_mv3, dan cap_user_stylesheet; env_chromium dan env_firefox bergantung pada target. Konstanta yang tidak dikenal bernilai salah. Direktif ini memilih cabang daftar, bukan kondisi halaman secara langsung.
Pengalihan inert
Kumpulan sumber daya tertutup diterima: redirect=noopjs atau redirect=noop.js menyediakan skrip kosong; redirect=nooptext atau redirect=noop.txt menyediakan teks kosong; redirect=noopjson menyediakan {}. Misalnya, ||ads.example/tracker.js$script,redirect=noopjs mengganti skrip dengan skrip inert saat aturan tersebut menang.
Ini adalah pengganti yang dikemas dalam paket, bukan pengalihan ke URL sembarang atau emulasi penuh pustaka pihak ketiga. Nama sumber daya yang tidak dikenal dan tindakan pengalihan pada aturan pengecualian ditolak. Blokir keras yang bersaing pada prioritas yang sama dapat mengalahkan pengalihan.
Batasan
Filter jaringan regex, removeparam, csp, badfilter, redirect-rule, dan pengubah yang tidak dikenal ditolak satu baris penuh. Referensi ini tidak menjanjikan kompatibilitas dengan setiap fitur EasyList, uBlock Origin, atau AdGuard. Sintaks yang tidak tercantum di sini bukan bukti bahwa sintaks itu sudah diuji lalu ditolak.
Aturan yang diterima tetap dapat melampaui kapasitas browser atau dikesampingkan oleh pengaturan perlindungan dan pengecualian. Periksa pratinjau dan status perlindungan; aturan yang dikonfigurasi bukan bukti adanya efek pada halaman.
Contoh
Pasangan blokir dan pengecualian yang terarah:
||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example
Baris pertama memblokir skrip pihak ketiga yang cocok. Baris kedua mengizinkan permintaan skrip yang cocok dan dimulai oleh checkout.example. Uji alur kerja situs web yang sebenarnya setelah memuat ulang; permintaan yang diizinkan juga dapat meloloskan iklan atau pelacakan.