Resultados e informes

Cada análisis se devuelve como un único objeto JSON plano: nada oculto, nada que tengas que volver a derivar. Los tres formatos de informe siguientes se construyen directamente sobre ese mismo objeto, cada uno pensado para un lector distinto: una persona revisando una pestaña del navegador, un panel de CI que solo entiende SARIF, o el propio formato de informe de implementación del W3C. Elige la forma que se ajuste a quién va a mirarlo realmente.

FormatoUso principalAudiencia
JSONIntegración, almacenamiento y procesamiento propioDesarrollo y plataformas
HTMLRevisión humana de un análisis concretoQA y auditoría
SARIFIntegración con herramientas de análisis de códigoEquipos de desarrollo y seguridad
EARLInteroperabilidad y evidencia de conformidad con ACTEstándares, investigación y conformidad

Esquema de salida

El contrato exacto que devuelve cada runner, y del que se deriva cualquier otro formato de informe: un objeto de resultado de nivel superior, una entrada por regla (incluyendo cada pass y notApplicable, nunca una lista de solo violaciones), detalle por ocurrencia hasta el elemento marcado, códigos explícitos de incertidumbre para todo lo que una regla no pudo decidir, y resultados agregados por criterio de conformidad de WCAG. Vale la pena leerlo una vez si estás construyendo algo sobre un resultado sin procesar. Ver Esquema de salida para la estructura completa.

Informe HTML

Ábrelo, entiéndelo: sin servidor, sin paso de compilación, sin tener que descifrar una salida JSON. Un resumen en lenguaje llano arriba, un resumen por WCAG agrupado por nivel de conformidad obtenido de los resultados compuestos propios del motor, y una tabla completa con función de búsqueda debajo para quien quiera profundizar. Este es el informe para entregar a un revisor que no quiere leer la salida sin procesar. Ver Informe HTML.

Informe SARIF

Envía un análisis directamente a GitHub Code Scanning o a cualquier otro panel que consuma SARIF, sin tener que escribir tú mismo un conversor. Las violaciones se mapean a resultados SARIF con una huella estable basada en contenido, así que un Baseline / allowlist sigue filtrando con limpieza y un panel puede seguir un hallazgo a través de commits en lugar de perderlo cada vez que cambia un número de línea. Ver Informe SARIF.

Informe EARL

Un informe de implementación EARL/JSON-LD del W3C que declara el resultado de cada regla, no solo los fallos: el formato que el grupo comunitario de ACT Rules acepta como evidencia de que un motor realmente implementa lo que dice. Una prueba útil cuando una afirmación de conformidad con ACT necesita ser verificable, no solo declarada. Ver Informe EARL.