Referência avançada · Avançado
Correções de páginas e scriptlets
Entenda as correções de páginas incluídas e a gramática de scriptlets. O Shield AdBlock 1.0.2 não a executa a partir de listas adicionadas ou suas regras.
Visão geral
As Correções de páginas usam pequenos assistentes incluídos no Shield para mudar comportamentos bem específicos de uma página. Um filtro pode escolher um assistente compatível e os argumentos dele; ele não pode fornecer código JavaScript novo para o Shield baixar e executar.
A chave Correções de páginas controla as correções integradas. Essas correções incluídas continuam sendo uma configuração separada e ainda usam os assistentes que vêm com o Shield. Os pacotes do Shield AdBlock 1.0.2 não incluem Correções de fontes adicionadas nem scriptlets das regras que você escreve, no Chrome, no Edge e no Firefox. Configurações avançadas pode exibir controles avançados; exibi-los não adiciona esse nível que ficou de fora.
Esses pacotes 1.0.2 trazem as correções integradas e deixam de fora o nível de scriptlets de listas adicionadas e regras personalizadas. Conteúdo incorporado de outros sites pode não ser afetado, mesmo quando uma correção integrada funciona na página principal.
Sintaxe
Os exemplos deste guia mostram a gramática dos filtros. Nos pacotes do Shield AdBlock 1.0.2, eles não são scriptlets executáveis de listas adicionadas nem de regras personalizadas. As Correções de páginas incluídas continuam usando os assistentes do pacote quando essa configuração está ativada.
Use uma forma limitada a um host, como:
news.example##+js(set-constant, adBlockDetected, false)
Isso solicita o assistente set-constant incluído no pacote para esse site. Não é código-fonte JavaScript nem CSS, nem garante que o site use essa propriedade. Os argumentos são separados por vírgulas; uma vírgula escapada é literal, e uma camada externa de aspas correspondentes é removida.
Inventário atual de assistentes
Esta versão reconhece os dez nomes canônicos a seguir. Os intervalos de argumentos não incluem o nome do assistente. Os exemplos mostram a chamada dentro de +js(...); coloque antes de cada um um escopo de site escolhido de propósito, como news.example##.
Role para o lado para ler a tabela inteira.
| Assistente e aliases | Finalidade e argumentos | Exemplo | Efeito esperado e limites |
|---|---|---|---|
set-constant; set |
Define uma propriedade com pontos como um dos valores permitidos; exatamente 2 argumentos. | +js(set-constant, adBlockDetected, false) |
Aplica o comportamento de constante compatível. Strings arbitrárias, código e números sem limite são rejeitados. |
abort-current-script; acs, abort-current-inline-script, acis |
Interrompe um script em execução quando ele acessa uma propriedade; propriedade mais trechos opcionais de conteúdo e de origem, de 1 a 3 argumentos. | +js(abort-current-script, adblock) |
Atua no acesso de scripts correspondentes, não em todos os scripts da página. Os trechos precisam ser literais. |
abort-on-property-read; aopr |
Interrompe o código quando ele lê uma propriedade; exatamente 1 argumento. | +js(abort-on-property-read, adblock) |
Afeta a cadeia de propriedades indicada, que precisa ser um caminho simples de identificadores com pontos. |
abort-on-property-write; aopw |
Interrompe o código quando ele grava uma propriedade; exatamente 1 argumento. | +js(abort-on-property-write, antiAdblock.write) |
Mira essa cadeia de propriedades; pode quebrar código legítimo que grava nela. |
prevent-addEventListener; aeld, addEventListener-defuser |
Impede o registro de listeners correspondentes; literais do evento e do código do manipulador, exatamente 2 argumentos. | +js(prevent-addEventListener, click, antiAdblock) |
As duas condições precisam corresponder. Predicados vazios ou ! não tornam a solicitação inteira incondicional; expressões regulares e opções extras de outros bloqueadores são rejeitadas. |
prevent-fetch; no-fetch-if |
Impede fetches correspondentes da página; condição mais token de resposta opcional, de 1 a 2 argumentos. | +js(prevent-fetch, url:ads method:POST, emptyObj) |
Exige que todas as condições literais informadas correspondam e devolve a resposta vazia escolhida. Não cancela todos os tipos de solicitação do navegador. |
prevent-xhr; no-xhr-if |
Impede XMLHttpRequests correspondentes; condição mais token de resposta opcional, de 1 a 2 argumentos. | +js(prevent-xhr, url:collect method:POST, emptyArr) |
Usa predicados de URL e de método; condições mode:, exclusivas de fetch, são rejeitadas. |
json-prune |
Remove propriedades JSON; caminhos a remover mais caminhos obrigatórios opcionais, de 1 a 2 argumentos. | +js(json-prune, payload.secret, payload.ready) |
Poda uma estrutura JSON correspondente quando os caminhos obrigatórios existem. É uma linguagem de caminhos limitada, não JSONPath arbitrário. |
prevent-window-open; nowoif, no-window-open-if, window.open-defuser |
Impede chamadas window.open correspondentes; de 0 a 1 argumento literal. |
+js(prevent-window-open) |
Sem predicado, impede as chamadas no escopo elegível. A correspondência literal pode examinar todos os argumentos da chamada juntos, não só a URL; opções de substituição e de atraso são rejeitadas. |
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser |
Impede timers correspondentes; trecho opcional do callback e atraso opcional, de 0 a 2 argumentos. | +js(prevent-setTimeout, adRefresh, 1000) |
Compara o texto do callback e o atraso informado. O atraso precisa ser finito; argumentos com expressão regular e opções extras são rejeitados. |
Nomes canônicos e aliases também podem ter o sufixo .js. Em regras novas, prefira os nomes canônicos para deixar a intenção mais clara.
Limites dos argumentos
Os assistentes de propriedades aceitam identificadores com pontos, não expressões com colchetes, chamadas de função nem cadeias que alcancem o protótipo. set-constant aceita os valores nomeados undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj e emptyArr, as formas vazias compatíveis e números inteiros de −32767 a 32767.
Os assistentes de solicitação aceitam condições literais limitadas, separadas por espaços. Os nomes de campo são url, method e, apenas para fetch, mode. Uma condição sem campo é um trecho da URL. A negação é feita com !; todos os predicados precisam corresponder. Os tokens de resposta são o texto vazio padrão, emptyStr, emptyObj e emptyArr. Campos e tokens de resposta desconhecidos são rejeitados.
A poda de JSON usa caminhos com pontos separados por espaços. Seus segmentos limitados podem incluir as formas compatíveis *, [], [-] e {-}, com restrições de posição e de processamento. Caminhos que alcançam o protótipo são rejeitados. Prefira um caminho simples com nome, a menos que você tenha conferido a estrutura aninhada exata e o efeito desejado.
Limites
Ter o nome de um scriptlet reconhecido não basta para que uma regra seja executada. A quantidade de argumentos, a gramática dos argumentos, o escopo do site e as chaves precisam atender aos requisitos, e o pacote precisa incluir esse nível. Os pacotes do Shield AdBlock 1.0.2 não incluem scriptlets de listas adicionadas e de regras personalizadas, então uma regra que segue essa gramática não é executada a partir de uma lista que você adicionou nem de uma regra que você escreveu. Argumentos com expressão regular, nomes desconhecidos e opções extras não compatíveis fazem a regra inteira ser ignorada. A sintaxe de scriptlets #%# do AdGuard não é aceita como substituta de ##+js(...).
As correções integradas têm suas próprias condições de aplicação e seu próprio estado de registro. Uma configuração ou um registro bem-sucedido não prova que um assistente foi executado, interceptou a chamada pretendida ou removeu um anúncio visível. Nenhum assistente garante a remoção de anúncios do YouTube nem a compatibilidade com todas as versões dos scriptlets de outro bloqueador.
Exemplos
Para desativar um assistente específico em um site, use uma exceção de scriptlet:
news.example#@#+js(set-constant)
A exceção só com o nome desativa esse assistente no escopo correspondente. news.example#@#+js() é a exceção mais ampla, para todos os scriptlets. Elas não desativam regras de rede nem cosméticas. Revise as exceções com o mesmo cuidado que as chamadas e recarregue o site depois das mudanças.