Esta página é uma tradução. Em caso de divergência, vale a página em inglês.

Referência avançada · Avançado

Sintaxe de filtros de rede

Use o subconjunto verificado de regras de rede e entenda exceções, escopos e linhas rejeitadas.

Visão geral

O Shield aceita um subconjunto limitado da linguagem de filtros usada por muitas listas de bloqueio. Ele ignora qualquer linha que não consiga representar com fidelidade. Remover uma opção desconhecida para que uma linha passe pode mudar o significado dela; em vez disso, leia a prévia.

Os exemplos abaixo usam domínios de exemplo reservados. Eles descrevem o comportamento das regras, não são regras que você deva instalar para um serviço real. Coloque uma linha por vez em Suas regras, revise o escopo e aplique só a mudança que você pretende.

Sintaxe

Padrões de URL

Role para o lado para ler a tabela inteira.

Finalidade Sintaxe e exemplo Efeito esperado e limites
Corresponder a um host ||ads.example^ Corresponde a esse host e aos subdomínios no limite do nome de host; não corresponde a notads.example. Uma regra sem tipo vale para solicitações comuns, não para a navegação da página principal.
Ancorar uma URL |https://cdn.example/ads.js| Exige que a URL comece e termine nessas posições. Uma mudança de esquema, caminho ou consulta pode impedir a correspondência.
Corresponder a parte de uma URL /ad/image/*$image Corresponde a URLs de solicitações de imagem que contêm o caminho indicado seguido de texto variável. O curinga final a diferencia de uma expressão regular delimitada por barras.
Usar um curinga ||cdn.example/ads/* * corresponde a texto variável; ^ corresponde a um separador ou ao fim da URL. Padrões com vários curingas têm limites de admissão e de processamento; padrões de qualquer tamanho não são aceitos.

Os padrões usam texto de URL em ASCII. Não inclua um #fragment: o navegador não envia fragmentos de URL em uma solicitação de rede.

Tipos, origens e escopos de site

Role para o lado para ler a tabela inteira.

Finalidade Exemplo Efeito esperado e limites
Restringir um tipo de solicitação ||ads.example^$script Vale para scripts. Outros tipos incluem image, stylesheet, font, media, object, xmlhttprequest, subdocument, document, ping, websocket e other. Os aliases incluem css, xhr, frame e doc.
Excluir um tipo ||ads.example^$~image Exclui imagens. Uma regra só com negações continua excluindo documentos principais; ela não vira uma regra de bloqueio de página.
Incluir todos os tipos ||ads.example^$all Inclui explicitamente os documentos principais. $all,~script inclui os outros tipos modelados. Use com cuidado.
Restringir a origem ||ads.example^$third-party Vale quando a solicitação é de terceiros em relação ao site que a iniciou. 3p é um alias; first-party, 1p, ~third-party e ~3p selecionam solicitações próprias.
Restringir o site que inicia a solicitação ||ads.example^$domain=news.example Limita a correspondência às solicitações iniciadas por esse host. É possível adicionar hosts iniciadores excluídos, como mostrado abaixo. Curingas de entidade em escopos $domain= de rede são rejeitados.

Um escopo de inclusão e exclusão usa | entre os nomes de host e ~ antes de um host excluído:

||ads.example^$domain=news.example|~pay.news.example

Exceções e prioridade

@@||ads.example^$script,domain=shop.example permite as solicitações de script correspondentes iniciadas pelo site indicado. Ela não pausa toda a proteção nesse site.

Uma exceção comum correspondente vence um bloqueio comum. Um bloqueio com $important vence uma exceção comum; uma exceção com $important vence esse bloqueio importante. Um texto que parece mais específico não cria um sistema geral de prioridade.

Para uma exceção de página inteira, @@||shop.example^$document desativa a proteção na página principal correspondente e no que ela carrega. Essa forma não aceita condição de origem, escopo de domínio iniciador, tipos de recurso extras nem $all. $document sem exceção é um bloqueio do documento principal, não uma pausa.

@@||news.example^$generichide interrompe a ocultação cosmética geral nesse host. As regras cosméticas específicas do site e o bloqueio de solicitações continuam disponíveis. Só é aceita uma exceção sobre uma âncora de host pura; caminhos, condições de origem e outros escopos de tipo não passam para essa forma exclusiva de host.

||popups.example^$popup corresponde aos destinos de navegação de pop-ups usando o gerenciador de pop-ups do Shield. @@||accounts.example^$popup,domain=shop.example é uma exceção de pop-up com escopo. Essas não são regras de solicitação de script e não configuram o bloqueador de pop-ups integrado do navegador.

Não combine $popup com tipos de solicitação, $all, $generichide ou uma ação de redirecionamento: uma única linha não consegue representar os dois escopos. Se o problema for uma janela de login, comece por janelas de login e de pagamento.

Arquivos hosts e blocos condicionais

Entradas hosts canônicas que usam os endereços de descarte 0.0.0.0, 127.0.0.1, ::1, :: ou 0 são convertidas em regras de âncora de host. Por exemplo, 0.0.0.0 ads.example passa a equivaler a ||ads.example^. Outros formatos de rede separados por espaços são rejeitados.

As listas podem usar !#if, !#else e !#endif aninhados com !, &&, || e parênteses. As condições são avaliadas para o pacote de destino do Shield. Entre as condições compartilhadas reconhecidas como verdadeiras estão true, env_mv3 e cap_user_stylesheet; env_chromium e env_firefox dependem do destino. Constantes desconhecidas são avaliadas como falsas. Essas diretivas escolhem ramos da lista, não condições da página em tempo real.

Redirecionamentos inertes

É aceito um conjunto fechado de recursos: redirect=noopjs ou redirect=noop.js fornece um script vazio; redirect=nooptext ou redirect=noop.txt fornece texto vazio; redirect=noopjson fornece {}. Por exemplo, ||ads.example/tracker.js$script,redirect=noopjs troca o script pelo script inerte quando a regra vence.

São substituições incluídas no pacote, não redirecionamentos para qualquer URL nem emulações completas de uma biblioteca de terceiros. Nomes de recurso desconhecidos e ações de redirecionamento em regras de exceção são rejeitados. Um bloqueio rígido concorrente com a mesma prioridade pode vencer um redirecionamento.

Limites

Filtros de rede com expressão regular, removeparam, csp, badfilter, redirect-rule e modificadores desconhecidos são rejeitados na linha inteira. Esta referência não promete compatibilidade com todos os recursos do EasyList, do uBlock Origin ou do AdGuard. A ausência de uma sintaxe aqui não prova que ela foi testada e rejeitada.

Regras aceitas ainda podem ultrapassar a capacidade do navegador ou ser anuladas por configurações de proteção e exceções. Confira a prévia e o status da proteção; uma regra configurada não prova um efeito na página.

Exemplos

Um par específico de bloqueio e exceção:

||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example

A primeira bloqueia os scripts de terceiros correspondentes. A segunda permite as solicitações de script correspondentes iniciadas por checkout.example. Depois de recarregar, teste o fluxo real do site; uma solicitação permitida também pode liberar publicidade ou rastreamento.

Ainda precisa de ajuda? Fale com o suporte