Uso desde la línea de comandos

Un comando en lugar de código. No requiere un framework de pruebas ni un script de Node y resulta adecuado para un paso del pipeline de CI o para una comprobación rápida de un artefacto de compilación.

Primer análisis

$ npm install -g @surea11y/cli
$ surea11y scan ./index.html
$ surea11y scan https://example.com/ --tags wcag2a,wcag2aa

Requiere Node.js ^20.19.0 || ^22.13.0 || >=24.0.0.

$ surea11y scan ./index.html
surea11y scan: file:///path/to/index.html
  pass: 6   fail: 3   cantTell: 4   notApplicable: 112
  occurrences by tier: fail: 3   cantTell: 5
FAIL (3 rule(s)):
  contrast-minimum  (serious, 1 fail occurrence(s))
    - html > body > main > p
      Element has insufficient color contrast of 2.85:1 (foreground: #999999,
      background: #ffffff, font size: 0px, font weight: normal). Expected
      contrast ratio of 4.5:1 (normal text).
cantTell — needs human review (4 rule(s)): contrast-computable, link-name-quality,
manual-review, page-title-patterns

Limitaciones

cantTell nunca afecta al código de salida: el 0 indica que no se han encontrado fallos, el 1 que existe al menos un resultado fail (o, analizando con --baseline, un resultado fail nuevo), y el 2 que se ha producido un error de uso o de análisis. El resultado fail es el caso que condiciona CI; consulta Baseline / allowlist para saber qué cuenta como "conocido" frente a "nuevo". La CLI solo lee HTML estático: un archivo local, o el cuerpo sin procesar de un GET HTTP(S), y nunca ejecuta el JavaScript de la página. Para páginas renderizadas en cliente, usa una de las integraciones (bindings) en su lugar, o llama al motor directamente contra un navegador real controlado mediante automatización (ver INTEGRATION.md Patrón 2).

Referencia completa de flags, contrato de reglas personalizadas y recetas de CI: docs/CLI.md. Para plantillas de pipeline de CI en concreto, ver Integración con CI.