Gelişmiş başvuru · Gelişmiş
Sayfa düzeltmeleri ve scriptlet'ler
Pakete dahil sayfa düzeltmelerini ve scriptlet dil bilgisini anlayın. Shield AdBlock 1.0.2 bunu eklenen listelerden veya kendi kurallarınızdan çalıştırmaz.
Genel bakış
Sayfa düzeltmeleri, sayfanın dar biçimde tanımlanmış davranışlarını değiştirmek için Shield ile birlikte paketlenen küçük yardımcıları kullanır. Bir filtre desteklenen bir yardımcıyı ve onun bağımsız değişkenlerini seçebilir; Shield'ın indirip çalıştırması için yeni JavaScript kodu sağlayamaz.
Sayfa düzeltmeleri anahtarı yerleşik düzeltmeleri denetler. Bu yerleşik düzeltmeler ayrı bir ayar olarak kalır ve Shield ile paketlenen yardımcıları kullanmaya devam eder. Shield AdBlock 1.0.2 paketleri Chrome, Edge ve Firefox'ta Eklenen kaynaklardan düzeltmeler seçeneğini ve kendi yazdığınız kurallardaki scriptlet'leri içermez. Gelişmiş ayarlar gelişmiş denetimleri gösterebilir; bunları göstermek, eksik olan bu katmanı eklemez.
Bu 1.0.2 paketleri yerleşik düzeltmeleri içerir; eklenen listeler ve özel kurallar için scriptlet katmanını içermez. Yerleşik bir düzeltme ana sayfada çalışsa bile başka web sitelerinden yerleştirilen içerik etkilenmeyebilir.
Söz dizimi
Bu kılavuzdaki örnekler filtre dil bilgisini gösterir. Shield AdBlock 1.0.2 paketlerinde bunlar, eklenen listelerden veya özel kurallardan çalıştırılabilen scriptlet'ler değildir. Pakete dahil Sayfa düzeltmeleri, bu ayar açıkken paketteki yardımcıları kullanmaya devam eder.
Ana bilgisayarla sınırlı bir biçim kullanın, örneğin:
news.example##+js(set-constant, adBlockDetected, false)
Bu, o web sitesi için pakete dahil set-constant yardımcısını ister. JavaScript kaynak kodu veya CSS değildir; sitenin bu özelliği kullandığını da garanti etmez. Bağımsız değişkenler virgülle ayrılır; kaçış karakterli virgül olduğu gibi kabul edilir ve eşleşen bir dış tırnak katmanı kaldırılır.
Güncel yardımcı listesi
Bu derleme aşağıdaki on standart adı tanır. Bağımsız değişken aralıklarına yardımcı adı dahil değildir. Örnekler +js(...) içindeki çağrıyı gösterir; her birinin önüne news.example## gibi bilinçli olarak seçilmiş bir web sitesi kapsamı ekleyin.
Tablonun tamamını okumak için yana kaydırın.
| Yardımcı ve takma adlar | Amaç ve bağımsız değişkenler | Örnek | Beklenen etki ve sınırlar |
|---|---|---|---|
set-constant; set |
Noktalı bir özelliği izin verilen bir değere ayarlar; tam olarak 2 bağımsız değişken. | +js(set-constant, adBlockDetected, false) |
Desteklenen sabit davranışını uygular. Rastgele dizeler, kod ve sınırsız sayılar reddedilir. |
abort-current-script; acs, abort-current-inline-script, acis |
Geçerli bir komut dosyasını bir özelliğe eriştiğinde durdurur; özellik artı isteğe bağlı içerik ve kaynak arama ifadeleri, 1–3 bağımsız değişken. | +js(abort-current-script, adblock) |
Sayfadaki her komut dosyasına değil, eşleşen komut dosyası erişimine etki eder. Arama ifadeleri birebir metin olmalıdır. |
abort-on-property-read; aopr |
Kod bir özelliği okuduğunda durdurur; tam olarak 1 bağımsız değişken. | +js(abort-on-property-read, adblock) |
Belirtilen özellik zincirini etkiler; bu zincir düz, noktalı bir tanımlayıcı yolu olmalıdır. |
abort-on-property-write; aopw |
Kod bir özelliğe yazdığında durdurur; tam olarak 1 bağımsız değişken. | +js(abort-on-property-write, antiAdblock.write) |
O özellik zincirini hedefler; oraya yazan meşru kodu bozabilir. |
prevent-addEventListener; aeld, addEventListener-defuser |
Eşleşen dinleyici kaydını engeller; olay ve işleyici kaynağı birebir metinleri, tam olarak 2 bağımsız değişken. | +js(prevent-addEventListener, click, antiAdblock) |
İki koşulun da eşleşmesi gerekir. Boş veya ! koşulları isteğin tamamını koşulsuz hâle getiremez; normal ifadeler ve başka engelleyicilerin ek seçenekleri reddedilir. |
prevent-fetch; no-fetch-if |
Sayfanın eşleşen fetch isteklerini engeller; koşul artı isteğe bağlı yanıt belirteci, 1–2 bağımsız değişken. | +js(prevent-fetch, url:ads method:POST, emptyObj) |
Verilen tüm birebir koşullarla eşleşir ve seçilen boş yanıtı sağlar. Tarayıcı düzeyindeki her istek türünü iptal etmez. |
prevent-xhr; no-xhr-if |
Eşleşen XMLHttpRequest'leri engeller; koşul artı isteğe bağlı yanıt belirteci, 1–2 bağımsız değişken. | +js(prevent-xhr, url:collect method:POST, emptyArr) |
URL ve yöntem koşullarını kullanır; yalnızca fetch'e özgü mode: koşulları reddedilir. |
json-prune |
JSON özelliklerini kaldırır; budanacak yollar artı isteğe bağlı zorunlu yollar, 1–2 bağımsız değişken. | +js(json-prune, payload.secret, payload.ready) |
Zorunlu yolları mevcut olduğunda eşleşen bir JSON yapısını budar. Bu, rastgele JSONPath değil, sınırlı bir yol dilidir. |
prevent-window-open; nowoif, no-window-open-if, window.open-defuser |
Eşleşen window.open çağrılarını engeller; 0–1 birebir bağımsız değişken. |
+js(prevent-window-open) |
Koşul olmadan, uygun kapsamındaki çağrıları engeller. Birebir eşleştirme yalnızca URL'yi değil, çağrının birleştirilmiş bağımsız değişkenlerini de inceleyebilir; değiştirme ve gecikme seçenekleri reddedilir. |
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser |
Eşleşen zamanlayıcıları engeller; isteğe bağlı geri çağırma arama ifadesi ve isteğe bağlı gecikme, 0–2 bağımsız değişken. | +js(prevent-setTimeout, adRefresh, 1000) |
Geri çağırma metniyle ve verilen gecikmeyle eşleşir. Gecikme sonlu olmalıdır; normal ifadeli bağımsız değişkenler ve ek seçenekler reddedilir. |
Standart adlar ve takma adlar .js sonekini de alabilir. Amacın daha kolay okunması için yeni kurallarda standart adları tercih edin.
Bağımsız değişken sınırları
Özellik yardımcıları noktalı tanımlayıcıları kabul eder; köşeli parantez ifadelerini, işlev çağrılarını veya prototipe uzanan zincirleri kabul etmez. set-constant; undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj ve emptyArr adlı değerleri, desteklenen boş biçimleri ve −32767 ile 32767 arasındaki tam sayıları kabul eder.
İstek yardımcıları, boşlukla ayrılmış sınırlı birebir koşulları kabul eder. Alan adları url, method ve yalnızca fetch için mode alanıdır. Alan adı olmayan bir koşul, URL'nin bir alt dizesidir. Olumsuzlama ! ile yapılır; tüm koşulların eşleşmesi gerekir. Yanıt belirteçleri varsayılan boş metin, emptyStr, emptyObj ve emptyArr belirteçleridir. Bilinmeyen alanlar veya yanıt belirteçleri reddedilir.
JSON budama, boşlukla ayrılmış noktalı yollar kullanır. Sınırlı yol parçaları, konum ve işlem kısıtlamalarıyla desteklenen *, [], [-] ve {-} biçimlerini içerebilir. Prototipe uzanan yollar reddedilir. Tam iç içe yapıyı ve istenen etkiyi kontrol etmediyseniz basit, adlandırılmış bir yolu tercih edin.
Sınırlar
Bir scriptlet adının tanınması, kuralın çalışması için yeterli değildir. Bağımsız değişken sayısı, bağımsız değişken dil bilgisi, web sitesi kapsamı ve anahtarlar koşulları karşılamalı, paket de bu katmanı içermelidir. Shield AdBlock 1.0.2 paketleri eklenen listeler ve özel kurallar için scriptlet'leri içermez; bu nedenle bu dil bilgisine uyan bir kural, eklediğiniz bir listeden veya yazdığınız bir kuraldan çalıştırılmaz. Normal ifadeli bağımsız değişkenler, bilinmeyen adlar ve desteklenmeyen ek seçenekler kuralın tamamının atlanmasına yol açar. AdGuard'ın #%# scriptlet söz dizimi, ##+js(...) yerine kabul edilmez.
Yerleşik düzeltmelerin kendi uygunluk koşulları ve kayıt durumları vardır. Başarılı bir yapılandırma veya kayıt, bir yardımcının çalıştığını, hedeflenen çağrıyı yakaladığını ya da görünür bir reklamı kaldırdığını kanıtlamaz. Hiçbir yardımcı, YouTube reklamlarının kaldırılmasını veya başka bir engelleyicinin scriptlet'lerinin her sürümüyle uyumluluğu garanti etmez.
Örnekler
Bir sitede belirli bir yardımcıyı devre dışı bırakmak için scriptlet istisnası kullanın:
news.example#@#+js(set-constant)
Yalnızca ad içeren istisna, o yardımcıyı eşleşen kapsamda devre dışı bırakır. news.example#@#+js(), tüm scriptlet'ler için daha geniş kapsamlı istisnadır. Bunlar ağ veya kozmetik kuralları devre dışı bırakmaz. İstisnaları çağrılar kadar dikkatle gözden geçirin ve değişikliklerden sonra web sitesini yeniden yükleyin.