Referencia avanzada · Avanzado
Sintaxis de filtros de red
Usa el subconjunto verificado de reglas de red y entiende las excepciones, los ámbitos y las líneas rechazadas.
Descripción general
Shield acepta un subconjunto limitado del lenguaje de filtros que comparten muchas listas de bloqueo. Omite cualquier línea que no pueda representar con fidelidad. Quitar una opción desconocida para que una línea pase puede cambiar su significado; en su lugar, revisa la vista previa.
Los ejemplos de abajo usan dominios de ejemplo reservados. Describen cómo se comportan las reglas, no son reglas que debas instalar para un servicio real. Añade una línea cada vez en Tus reglas, revisa su alcance y aplica solo el cambio que pretendes.
Sintaxis
Patrones de URL
Desplázate hacia los lados para leer la tabla completa.
| Propósito | Sintaxis y ejemplo | Efecto esperado y límites |
|---|---|---|
| Coincidir con un host | ||ads.example^ |
Coincide con ese host y sus subdominios en el límite del nombre de host; no coincide con notads.example. Una regla sin tipo se aplica a solicitudes normales, no a la navegación de la página principal. |
| Anclar una URL | |https://cdn.example/ads.js| |
Exige que la URL empiece y termine en esas posiciones. Un cambio de esquema, ruta o consulta puede impedir la coincidencia. |
| Coincidir con parte de una URL | /ad/image/*$image |
Coincide con URL de solicitudes de imagen que contienen la ruta indicada seguida de texto variable. El comodín final la distingue de una expresión regular delimitada por barras. |
| Usar un comodín | ||cdn.example/ads/* |
* coincide con texto variable; ^ coincide con un separador o con el final de la URL. Los patrones con varios comodines tienen límites de admisión y de trabajo; no se aceptan patrones de cualquier tamaño. |
Los patrones usan texto de URL en ASCII. No incluyas un #fragment: el navegador no envía los fragmentos de URL como parte de una solicitud de red.
Tipos, partes y ámbitos de sitio
Desplázate hacia los lados para leer la tabla completa.
| Propósito | Ejemplo | Efecto esperado y límites |
|---|---|---|
| Restringir un tipo de solicitud | ||ads.example^$script |
Se aplica a scripts. Otros tipos son image, stylesheet, font, media, object, xmlhttprequest, subdocument, document, ping, websocket y other. Entre los alias están css, xhr, frame y doc. |
| Excluir un tipo | ||ads.example^$~image |
Excluye imágenes. Una regla solo con negaciones sigue excluyendo los documentos principales; no se convierte en una regla que bloquea páginas. |
| Incluir todos los tipos | ||ads.example^$all |
Incluye de forma explícita los documentos principales. $all,~script incluye los demás tipos modelados. Úsalo con cuidado. |
| Restringir la parte | ||ads.example^$third-party |
Se aplica cuando la solicitud es de terceros respecto al sitio que la inicia. 3p es un alias; first-party, 1p, ~third-party y ~3p seleccionan solicitudes propias. |
| Restringir el sitio que inicia la solicitud | ||ads.example^$domain=news.example |
Limita la coincidencia a las solicitudes iniciadas por ese host. Se pueden añadir hosts iniciadores excluidos como se muestra abajo. Los comodines de entidad en los ámbitos $domain= de red se rechazan. |
Un ámbito de inclusión y exclusión usa | entre nombres de host y ~ delante de un host excluido:
||ads.example^$domain=news.example|~pay.news.example
Excepciones y prioridad
@@||ads.example^$script,domain=shop.example permite las solicitudes de script que coinciden y que inicia el sitio indicado. No pausa toda la protección en ese sitio.
Una excepción normal que coincide gana a un bloqueo normal. Un bloqueo con $important gana a una excepción normal; una excepción con $important gana a ese bloqueo importante. Que un texto parezca más específico no establece una prioridad general.
Para una excepción de página completa, @@||shop.example^$document desactiva la protección en la página principal que coincide y en lo que carga. Esta forma no admite una condición de parte, un ámbito de dominio iniciador, tipos de recurso adicionales ni $all. $document sin excepción es un bloqueo del documento principal, no una pausa.
@@||news.example^$generichide detiene la ocultación cosmética general en ese host. Mantiene disponibles las reglas cosméticas específicas del sitio y el bloqueo de solicitudes. Solo se admite una excepción sobre un ancla de host pura; las rutas, las condiciones de parte y otros ámbitos de tipo no se trasladan a esta forma solo para hosts.
Destinos de ventanas emergentes
||popups.example^$popup coincide con los destinos de navegación de ventanas emergentes mediante el gestor de ventanas emergentes de Shield. @@||accounts.example^$popup,domain=shop.example es una excepción de ventana emergente con ámbito. No son reglas de solicitudes de script ni configuran el bloqueador de ventanas emergentes integrado del navegador.
No combines $popup con tipos de solicitud, $all, $generichide ni una acción de redirección: una sola línea no puede representar ambos ámbitos. Si tienes un problema con una ventana de inicio de sesión, empieza por ventanas de inicio de sesión y de pago.
Archivos hosts y bloques condicionales
Las entradas hosts canónicas que usan las direcciones sumidero 0.0.0.0, 127.0.0.1, ::1, :: o 0 se traducen en reglas de ancla de host. Por ejemplo, 0.0.0.0 ads.example pasa a ser el equivalente de ||ads.example^. Se rechazan otras formas de red separadas por espacios.
Las listas pueden usar !#if, !#else y !#endif anidados con !, &&, || y paréntesis. Las condiciones se evalúan para el paquete de destino de Shield. Entre las condiciones compartidas reconocidas como verdaderas están true, env_mv3 y cap_user_stylesheet; env_chromium y env_firefox dependen del destino. Las constantes desconocidas se evalúan como falsas. Estas directivas seleccionan ramas de la lista, no condiciones de la página en vivo.
Redirecciones inertes
Se acepta un conjunto cerrado de recursos: redirect=noopjs o redirect=noop.js proporciona un script vacío; redirect=nooptext o redirect=noop.txt proporciona texto vacío; redirect=noopjson proporciona {}. Por ejemplo, ||ads.example/tracker.js$script,redirect=noopjs sustituye el script por uno inerte cuando la regla gana.
Son sustituciones incluidas en el paquete, no redirecciones a cualquier URL ni emulaciones completas de una biblioteca de terceros. Se rechazan los nombres de recurso desconocidos y las acciones de redirección en reglas de excepción. Un bloqueo estricto que compite con la misma prioridad puede ganar a una redirección.
Límites
Los filtros de red con expresiones regulares, removeparam, csp, badfilter, redirect-rule y los modificadores desconocidos se rechazan como línea completa. Esta referencia no promete compatibilidad con todas las funciones de EasyList, uBlock Origin o AdGuard. Que una sintaxis no aparezca aquí no prueba que se haya probado y rechazado.
Las reglas aceptadas pueden superar igualmente la capacidad del navegador o quedar anuladas por ajustes de protección y excepciones. Revisa la vista previa y el estado de la protección; una regla configurada no prueba que tenga efecto en la página.
Ejemplos
Un par concreto de bloqueo y excepción:
||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example
La primera bloquea los scripts de terceros que coinciden. La segunda permite las solicitudes de script que coinciden y que inicia checkout.example. Después de recargar, prueba el flujo real del sitio; una solicitud permitida también puede permitir publicidad o rastreo.