Referensi lanjutan · Lanjutan
Perbaikan halaman dan scriptlet
Pahami perbaikan halaman bawaan dan tata bahasa scriptlet. Shield AdBlock 1.0.2 tidak menjalankannya dari daftar tambahan atau aturan kustom.
Ringkasan
Perbaikan halaman menggunakan helper kecil yang dikemas bersama Shield untuk mengubah perilaku halaman yang didefinisikan secara sempit. Filter dapat memilih helper yang didukung beserta argumennya; filter tidak dapat menyediakan kode JavaScript baru untuk diunduh dan dijalankan oleh Shield.
Sakelar Perbaikan halaman mengontrol perbaikan bawaan. Perbaikan bawaan tersebut tetap menjadi pengaturan terpisah dan tetap menggunakan helper yang dikemas bersama Shield. Paket Shield AdBlock 1.0.2 tidak menyertakan Perbaikan dari sumber tambahan maupun scriptlet dari aturan yang Anda tulis, di Chrome, Edge, dan Firefox. Pengaturan lanjutan dapat menampilkan kontrol lanjutan; menampilkannya tidak menambahkan tingkat yang tidak disertakan itu.
Paket 1.0.2 ini berisi perbaikan bawaan dan tidak menyertakan tingkat scriptlet dari daftar tambahan dan aturan kustom. Konten yang disematkan dari situs web lain mungkin tetap tidak terpengaruh, meskipun perbaikan bawaan berfungsi di halaman utama.
Sintaks
Contoh dalam panduan ini menunjukkan tata bahasa filter. Contoh tersebut bukan scriptlet daftar tambahan atau aturan kustom yang dapat dijalankan dalam paket Shield AdBlock 1.0.2. Perbaikan halaman bawaan tetap menggunakan helper dalam paket saat pengaturan itu aktif.
Gunakan bentuk yang dibatasi pada host, seperti:
news.example##+js(set-constant, adBlockDetected, false)
Ini meminta helper set-constant yang dikemas dalam paket untuk situs web tersebut. Ini bukan kode sumber JavaScript, bukan CSS, dan bukan jaminan bahwa situs menggunakan properti itu. Argumen dipisahkan dengan koma; koma yang di-escape dianggap literal, dan satu lapisan tanda kutip luar yang berpasangan akan dihapus.
Daftar helper saat ini
Build ini mengenali sepuluh nama kanonis berikut. Rentang argumen tidak mencakup nama helper. Contoh menunjukkan pemanggilan di dalam +js(...); awali masing-masing dengan cakupan situs web yang dipilih secara sengaja, seperti news.example##.
Geser ke samping untuk membaca seluruh tabel.
| Helper dan alias | Tujuan dan argumen | Contoh | Efek yang diharapkan dan batasan |
|---|---|---|---|
set-constant; set |
Menetapkan properti bertitik ke satu nilai yang diizinkan; tepat 2 argumen. | +js(set-constant, adBlockDetected, false) |
Memasang perilaku konstanta yang didukung. String sembarang, kode, dan angka tanpa batas ditolak. |
abort-current-script; acs, abort-current-inline-script, acis |
Menghentikan skrip yang sedang berjalan saat mengakses properti; properti ditambah penanda konten dan sumber opsional, 1–3 argumen. | +js(abort-current-script, adblock) |
Bekerja pada akses skrip yang cocok, bukan semua skrip di halaman. Penanda harus berupa literal. |
abort-on-property-read; aopr |
Menghentikan kode saat membaca properti; tepat 1 argumen. | +js(abort-on-property-read, adblock) |
Memengaruhi rantai properti yang disebutkan, yang harus berupa jalur pengenal bertitik sederhana. |
abort-on-property-write; aopw |
Menghentikan kode saat menulis properti; tepat 1 argumen. | +js(abort-on-property-write, antiAdblock.write) |
Menargetkan rantai properti tersebut; dapat merusak kode sah yang menulis ke sana. |
prevent-addEventListener; aeld, addEventListener-defuser |
Mencegah pendaftaran listener yang cocok; literal event dan sumber handler, tepat 2 argumen. | +js(prevent-addEventListener, click, antiAdblock) |
Kedua kondisi harus cocok. Predikat kosong atau ! tidak dapat membuat seluruh permintaan menjadi tanpa syarat; regex dan opsi tambahan dari pemblokir lain ditolak. |
prevent-fetch; no-fetch-if |
Mencegah fetch halaman yang cocok; kondisi ditambah token respons opsional, 1–2 argumen. | +js(prevent-fetch, url:ads method:POST, emptyObj) |
Mencocokkan semua kondisi literal yang diberikan dan menyediakan respons kosong yang dipilih. Tidak membatalkan setiap jenis permintaan di tingkat browser. |
prevent-xhr; no-xhr-if |
Mencegah XMLHttpRequest yang cocok; kondisi ditambah token respons opsional, 1–2 argumen. | +js(prevent-xhr, url:collect method:POST, emptyArr) |
Menggunakan predikat URL dan metode; kondisi mode: yang khusus untuk fetch ditolak. |
json-prune |
Menghapus properti JSON; jalur yang dipangkas ditambah jalur wajib opsional, 1–2 argumen. | +js(json-prune, payload.secret, payload.ready) |
Memangkas struktur JSON yang cocok jika jalur wajibnya ada. Ini adalah bahasa jalur yang dibatasi, bukan JSONPath sembarang. |
prevent-window-open; nowoif, no-window-open-if, window.open-defuser |
Mencegah panggilan window.open yang cocok; 0–1 argumen literal. |
+js(prevent-window-open) |
Tanpa predikat, mencegah panggilan dalam cakupan yang memenuhi syarat. Pencocokan literal dapat memeriksa gabungan argumen panggilan, bukan hanya URL; opsi penggantian dan penundaan ditolak. |
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser |
Mencegah timer yang cocok; penanda callback opsional dan penundaan opsional, 0–2 argumen. | +js(prevent-setTimeout, adRefresh, 1000) |
Mencocokkan teks callback dan penundaan yang diberikan. Penundaan harus terbatas; argumen regex dan opsi tambahan ditolak. |
Nama kanonis dan alias juga dapat diberi akhiran .js. Utamakan nama kanonis dalam aturan baru agar maksudnya lebih mudah dibaca.
Batas argumen
Helper properti menerima pengenal bertitik, bukan ekspresi kurung siku, panggilan fungsi, atau rantai yang menjangkau prototipe. set-constant menerima nilai bernama undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj, dan emptyArr, bentuk kosong yang didukung, serta bilangan bulat dari −32767 hingga 32767.
Helper permintaan menerima kondisi literal terbatas yang dipisahkan spasi. Nama kolomnya adalah url, method, dan, khusus untuk fetch, mode. Kondisi tanpa nama kolom adalah substring URL. Negasi tersedia dengan !; semua predikat harus cocok. Token respons adalah teks kosong bawaan, emptyStr, emptyObj, dan emptyArr. Kolom atau token respons yang tidak dikenal ditolak.
Pemangkasan JSON menggunakan jalur bertitik yang dipisahkan spasi. Segmennya yang terbatas dapat mencakup bentuk *, [], [-], dan {-} yang didukung, dengan batasan posisi dan pemrosesan. Jalur yang menjangkau prototipe ditolak. Utamakan jalur bernama yang sederhana, kecuali Anda sudah memeriksa struktur bertingkat yang tepat dan efek yang diinginkan.
Batasan
Nama scriptlet yang dikenali saja tidak cukup agar aturan dijalankan. Jumlah argumen, tata bahasa argumen, cakupan situs web, dan sakelarnya harus memenuhi syarat, dan paket harus menyertakan tingkat tersebut. Paket Shield AdBlock 1.0.2 tidak menyertakan scriptlet dari daftar tambahan dan aturan kustom, sehingga aturan yang sesuai dengan tata bahasa ini tidak dijalankan dari daftar yang Anda tambahkan atau aturan yang Anda tulis. Argumen regex, nama yang tidak dikenal, dan opsi tambahan yang tidak didukung menyebabkan seluruh aturan dilewati. Sintaks scriptlet #%# AdGuard tidak diterima sebagai pengganti ##+js(...).
Perbaikan bawaan memiliki syarat kelayakan dan status pendaftarannya sendiri. Konfigurasi atau pendaftaran yang berhasil tidak membuktikan bahwa helper telah berjalan, mencegat panggilan yang dimaksud, atau menghapus iklan yang terlihat. Tidak ada helper yang menjamin penghapusan iklan YouTube atau kompatibilitas dengan setiap versi scriptlet pemblokir lain.
Contoh
Untuk menonaktifkan helper tertentu di sebuah situs, gunakan pengecualian scriptlet:
news.example#@#+js(set-constant)
Pengecualian yang hanya berisi nama menonaktifkan helper tersebut dalam cakupan yang cocok. news.example#@#+js() adalah pengecualian yang lebih luas untuk semua scriptlet. Pengecualian ini tidak menonaktifkan aturan jaringan atau kosmetik. Tinjau pengecualian sama cermatnya dengan pemanggilan, lalu muat ulang situs web setelah melakukan perubahan.