Esta página es una traducción. Si hay alguna diferencia, prevalece la página en inglés.

Referencia avanzada · Avanzado

Correcciones de páginas y scriptlets

Conoce las correcciones de páginas incluidas y la gramática de scriptlets. Shield AdBlock 1.0.2 no la ejecuta desde listas añadidas ni reglas propias.

Descripción general

Las Correcciones de páginas usan pequeños asistentes incluidos en Shield para cambiar comportamientos muy concretos de una página. Un filtro puede seleccionar un asistente compatible y sus argumentos; no puede aportar código JavaScript nuevo para que Shield lo descargue y lo ejecute.

El interruptor Correcciones de páginas controla las correcciones integradas. Esas correcciones incluidas siguen siendo un ajuste aparte y continúan usando los asistentes que vienen con Shield. Los paquetes de Shield AdBlock 1.0.2 omiten Correcciones de fuentes añadidas y los scriptlets de las reglas que escribes tú, en Chrome, Edge y Firefox. Ajustes avanzados puede mostrar controles avanzados; mostrarlos no añade ese nivel omitido.

Estos paquetes 1.0.2 contienen las correcciones integradas y omiten el nivel de scriptlets de listas añadidas y reglas personalizadas. El contenido insertado desde otros sitios puede no verse afectado, aunque una corrección integrada funcione en la página principal.

Sintaxis

Los ejemplos de esta guía muestran la gramática de los filtros. En los paquetes de Shield AdBlock 1.0.2 no son scriptlets ejecutables de listas añadidas ni de reglas personalizadas. Las Correcciones de páginas incluidas siguen usando los asistentes del paquete cuando ese ajuste está activado.

Usa una forma limitada a un host, como:

news.example##+js(set-constant, adBlockDetected, false)

Esto solicita el asistente set-constant incluido en el paquete para ese sitio. No es código fuente JavaScript ni CSS, ni garantiza que el sitio use esa propiedad. Los argumentos se separan con comas; una coma escapada es literal y se elimina una capa exterior de comillas que coincidan.

Inventario actual de asistentes

Esta compilación reconoce los diez nombres canónicos siguientes. Los rangos de argumentos no incluyen el nombre del asistente. Los ejemplos muestran la invocación dentro de +js(...); antepón a cada uno un ámbito de sitio elegido a propósito, como news.example##.

Desplázate hacia los lados para leer la tabla completa.

Asistente y alias Propósito y argumentos Ejemplo Efecto esperado y límites
set-constant; set Asigna a una propiedad con puntos uno de los valores permitidos; exactamente 2 argumentos. +js(set-constant, adBlockDetected, false) Aplica el comportamiento de constante admitido. Se rechazan cadenas arbitrarias, código y números sin límite.
abort-current-script; acs, abort-current-inline-script, acis Detiene un script en curso cuando accede a una propiedad; la propiedad más fragmentos opcionales de contenido y de origen, de 1 a 3 argumentos. +js(abort-current-script, adblock) Actúa sobre el acceso de scripts que coinciden, no sobre todos los scripts de la página. Los fragmentos deben ser literales.
abort-on-property-read; aopr Detiene el código cuando lee una propiedad; exactamente 1 argumento. +js(abort-on-property-read, adblock) Afecta a la cadena de propiedades indicada, que debe ser una ruta simple de identificadores con puntos.
abort-on-property-write; aopw Detiene el código cuando escribe una propiedad; exactamente 1 argumento. +js(abort-on-property-write, antiAdblock.write) Se dirige a esa cadena de propiedades; puede romper código legítimo que escriba en ella.
prevent-addEventListener; aeld, addEventListener-defuser Impide registrar escuchadores que coinciden; literales del evento y del código del controlador, exactamente 2 argumentos. +js(prevent-addEventListener, click, antiAdblock) Deben coincidir ambas condiciones. Los predicados vacíos o ! no pueden hacer que toda la solicitud sea incondicional; se rechazan las expresiones regulares y las opciones adicionales de otros bloqueadores.
prevent-fetch; no-fetch-if Impide las solicitudes fetch de la página que coinciden; condición más un token de respuesta opcional, de 1 a 2 argumentos. +js(prevent-fetch, url:ads method:POST, emptyObj) Exige que coincidan todas las condiciones literales indicadas y devuelve la respuesta vacía elegida. No cancela todos los tipos de solicitud del navegador.
prevent-xhr; no-xhr-if Impide las XMLHttpRequest que coinciden; condición más un token de respuesta opcional, de 1 a 2 argumentos. +js(prevent-xhr, url:collect method:POST, emptyArr) Usa predicados de URL y de método; se rechazan las condiciones mode:, que solo valen para fetch.
json-prune Elimina propiedades JSON; rutas a eliminar más rutas obligatorias opcionales, de 1 a 2 argumentos. +js(json-prune, payload.secret, payload.ready) Recorta una estructura JSON que coincide cuando existen sus rutas obligatorias. Es un lenguaje de rutas limitado, no JSONPath arbitrario.
prevent-window-open; nowoif, no-window-open-if, window.open-defuser Impide las llamadas a window.open que coinciden; de 0 a 1 argumento literal. +js(prevent-window-open) Sin predicado, impide las llamadas en su ámbito admitido. La coincidencia literal puede examinar todos los argumentos de la llamada unidos, no solo la URL; se rechazan las opciones de sustitución y de retraso.
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser Impide los temporizadores que coinciden; fragmento opcional de la función de retorno y retraso opcional, de 0 a 2 argumentos. +js(prevent-setTimeout, adRefresh, 1000) Comprueba el texto de la función de retorno y el retraso indicado. El retraso debe ser finito; se rechazan los argumentos con expresiones regulares y las opciones adicionales.

Los nombres canónicos y los alias también pueden llevar el sufijo .js. En las reglas nuevas, usa preferiblemente los nombres canónicos para que la intención se entienda mejor.

Límites de los argumentos

Los asistentes de propiedades aceptan identificadores con puntos, no expresiones con corchetes, llamadas a funciones ni cadenas que lleguen al prototipo. set-constant acepta los valores con nombre undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj y emptyArr, las formas vacías admitidas y los números enteros de −32767 a 32767.

Los asistentes de solicitudes aceptan condiciones literales limitadas separadas por espacios. Los nombres de campo son url, method y, solo para fetch, mode. Una condición sin campo es una subcadena de la URL. La negación se indica con !; todos los predicados deben coincidir. Los tokens de respuesta son el texto vacío predeterminado, emptyStr, emptyObj y emptyArr. Se rechazan los campos y tokens de respuesta desconocidos.

La eliminación de JSON usa rutas con puntos separadas por espacios. Sus segmentos limitados pueden incluir las formas admitidas *, [], [-] y {-}, con restricciones de posición y de trabajo. Se rechazan las rutas que llegan al prototipo. Usa preferiblemente una ruta simple con nombre, salvo que hayas comprobado la estructura anidada exacta y el efecto que buscas.

Límites

Que se reconozca el nombre de un scriptlet no basta para que una regla se ejecute. Su número de argumentos, la gramática de los argumentos, el ámbito del sitio y los interruptores deben cumplir los requisitos, y el paquete debe incluir ese nivel. Los paquetes de Shield AdBlock 1.0.2 omiten los scriptlets de listas añadidas y reglas personalizadas, así que una regla que se ajuste a esta gramática no se ejecuta desde una lista que hayas añadido ni desde una regla que hayas escrito. Los argumentos con expresiones regulares, los nombres desconocidos y las opciones adicionales no admitidas hacen que se omita toda la regla. La sintaxis de scriptlets #%# de AdGuard no se acepta como sustituto de ##+js(...).

Las correcciones integradas tienen sus propias condiciones de aplicación y su propio estado de registro. Que la configuración o el registro se completen no prueba que un asistente se haya ejecutado, haya interceptado la llamada prevista o haya quitado un anuncio visible. Ningún asistente garantiza quitar los anuncios de YouTube ni la compatibilidad con todas las versiones de los scriptlets de otro bloqueador.

Ejemplos

Para desactivar un asistente concreto en un sitio, usa una excepción de scriptlet:

news.example#@#+js(set-constant)

La excepción solo con el nombre desactiva ese asistente en el ámbito que coincide. news.example#@#+js() es la excepción más amplia, para todos los scriptlets. Estas excepciones no desactivan las reglas de red ni las cosméticas. Revisa las excepciones con el mismo cuidado que las invocaciones y recarga el sitio después de hacer cambios.

¿Aún necesitas ayuda? Contacta con nosotros