Glosario

a11y

Una abreviatura de accesibilidad: interpretada como la letra a seguida de 11 caracteres y luego la letra y.

Agora

Agora es el repositorio de artefactos interno de Deque. Está basado en una instancia de Artifactory. A través de Agora, los usuarios pueden descargar componentes de Axe DevTools, gestionar y distribuir conjuntos de reglas personalizadas, y más.

Clave API

Una clave API autoriza al CLI, Axe Watcher, o las API web a enviar resultados de accesibilidad a Axe Developer Hub o Axe Reports. Trata tu clave API como una credencial secreta: no la cometas en el control de código fuente ni la compartas, y guárdala en una variable de entorno o en el gestor de secretos de tu plataforma CI/CD.

ARIA

Aplicaciones de Internet Enriquecidas y Accesibles (ARIA) es una especificación técnica publicada por el Consorcio World Wide Web, o W3C, que define maneras de aumentar la accesibilidad de las páginas web, en particular, el contenido dinámico y los componentes de la interfaz de usuario desarrollados con Ajax, HTML, JavaScript, y tecnologías relacionadas.

Tecnología de Asistencia

Algunas personas con discapacidad pueden no ser capaces de interactuar con software y sitios web por sí mismas. Estas personas necesitan tecnología de asistencia para usar internet de manera equitativa. Una forma muy común de tecnología de asistencia es un lector de pantalla. Estos dispositivos leen el texto en la pantalla en voz alta para personas con baja visión o ciegas. Hay muchos lectores de pantalla diferentes dependiendo de la plataforma. Algunos ejemplos son NVDA o JAWS en PC, VoiceOver en Mac, o TalkBack en Android.

Prácticas Recomendadas

Las prácticas recomendadas de Deque son técnicas probadas en el tiempo que ofrecen resultados de accesibilidad deseados cuando faltan o son insuficientes métodos formales específicos. Aunque no están incluidas oficialmente en ningún conjunto de reglas de accesibilidad establecidas, seguir las prácticas recomendadas de Deque puede mejorar la accesibilidad y la calidad general de la página web evaluada. Cabe destacar que el no cumplimiento de las directrices de prácticas recomendadas de Deque no indica automáticamente un fracaso. Además, se requiere juicio experto para considerar la adecuación en el contexto de los objetivos de la aplicación, sitio o página. A veces la técnica de accesibilidad de prácticas recomendadas no es aplicable o práctica para resolver un problema específico. Ver Prácticas Recomendadas para las reglas que componen el conjunto de reglas de prácticas recomendadas.

Plataforma de Automatización de Navegadores

Para Axe Watcher, un plataforma de automatización de navegadores es un marco que usas para automatizar las pruebas de tu sitio web. Las plataformas incluyen Cypress, Playwright, Puppeteer, WebdriverIO y WebDriverJS. Para más información, consulta

• Cypress
• Playwright o Playwright Test
• Puppeteer
• WebdriverIO o WebdriverIO Testrunner
• WebDriverJS

Punto de Control

Un método probado para la prueba de requisitos de accesibilidad creado por el equipo de expertos en a11y de Deque que aumenta la consistencia y precisión de los resultados de las pruebas. Basados en los Criterios de Éxito WCAG, proporcionan una categorización e interpretación más explícita de esas directrices, donde los fallos se separan típicamente por tipo de contenido. Los Puntos de Control de Deque ayudan a los revisores a producir resultados de prueba consistentes y precisos durante las evaluaciones de accesibilidad. Un punto de control se refiere a la sección más relevante y aplicable del listado maestro de Puntos de Control de Deque (y sus requisitos) que son una parte importante del Camino de Deque hacia la igualdad digital.

Pruebas de Componentes

Con Cypress o Playwright y Axe Watcher, puedes probar componentes individuales (como componentes React) de forma aislada. Contrasta esto con Pruebas e2e, que prueba toda la aplicación web en su implementación del mundo real. Axe Developer Hub puede detectar problemas de accesibilidad en escenarios de extremo a extremo y puede probar componentes de forma aislada con Cypress. Consulta Pruebas e2e.

Anulación de Configuración

Una anulación de configuración te permite personalizar configuraciones para ejecuciones de prueba específicas a través de la propiedad configurationOverrides (JavaScript/TypeScript) o en tu configuración de prueba Clase ConfigurationOverrides (Java). Estas anulaciones deben cumplir con las configuraciones de configuración global de tu organización y pueden incluir cambios a estándares de accesibilidad, prácticas recomendadas, reglas experimentales y versiones de axe-core.

Conjunto de Reglas Personalizadas

Un conjunto de reglas personalizadas se construye a partir de un archivo JSON que contiene datos de reglas (reglas y verificaciones) pasados a los componentes de Axe DevTools para agregar nuevas reglas, cambiar la severidad/impacto de una regla o eliminar una regla de las pruebas.

Duplicado

Un duplicado es el mismo problema de accesibilidad visto en el mismo nodo del modelo de objeto de documento (DOM) en múltiples estados de página. Si solucionas un problema con duplicados, todos sus duplicados desaparecerán porque todos son el mismo problema.

Dos resultados se tratan como el mismo problema cuando coinciden los siguientes tres aspectos:

• La regla que fue violada.
• El elemento. Axe Developer Hub identifica el elemento por su selector CSS y su XPath, y también por su selector de ascendencia cuando ancestry está habilitado. La coincidencia en cualquiera de estos es suficiente.
• La URL de la página, comparada en su totalidad, incluyendo cualquier cadena de consulta.

Nada más se compara. En particular, el título de la página y el HTML del elemento no tienen efecto sobre si un resultado se trata como un duplicado.

La misma comparación determina si un problema es nuevo: un resultado que no coincide con nada en la línea base aplicable se cuenta como nuevo. Esto significa que si el URL de una página o sus selectores de elementos cambian entre escaneos, el mismo problema subyacente se reporta como nuevo cada vez. Vea Uso de selectores dinámicos para saber cómo corregir esto.

Pruebas e2e

Las pruebas de extremo a extremo, o e2e, se refieren a probar la funcionalidad de toda la aplicación web probando su implementación del mundo real. Con Axe Developer Hub, puedes probar escenarios de extremo a extremo para problemas de accesibilidad y puedes probar componentes individuales de forma aislada con Cypress. Consulta también Pruebas de Componentes.

Evento

Para rastrear el uso de API o CLI, la biblioteca de métricas crea eventos y los envía al servicio de uso. Los eventos contienen información sobre el uso, como el número de reglas de accesibilidad violadas durante un escaneo de página web y la fecha y hora en que se completó un escaneo de accesibilidad.

Reglas experimentales

Reglas experimentales todavía se están desarrollando y probando para abordar nuevas tecnologías o una mayor comprensión y conciencia de los problemas de accesibilidad. No se debe depender de estas reglas en entornos de producción porque aún están en desarrollo y están sujetas a falsos positivos. Eventualmente, las reglas de este conjunto podrían formar parte de los estándares de accesibilidad. Las reglas experimentales están deshabilitadas por defecto. Consulte Reglas experimentales para ver las reglas que componen este conjunto en la última versión de axe-core.

Vaciar

La función vaciar escribe los resultados de tus pruebas de Axe Watcher en el servidor de Deque y es necesaria para asegurarse de que los resultados sean registrados por Axe Developer Hub. Necesitas llamar a la función flush en tu conjunto de pruebas.

Sin Git

Sin Git es una de las dos formas de datos a las que un proyecto de Developer Hub puede bloquearse: el conjunto de pruebas del proyecto no usa un repositorio Git. Un proyecto se bloquea a Gitless o a Git, basado en su primera sesión exitosa; una ejecución posterior con la otra forma de datos es rechazada en lugar de aceptada. No estás obligado a usar un repositorio Git, pero un repositorio Git te permite asociar defectos de accesibilidad con cambios específicos en el código, lo que ayuda en su resolución. Consulta Bloqueo del Proyecto.

Configuración global

Configuración global es parte de Configuración de Axe que le permite configurar varias opciones en un solo lugar para ser compartidas entre diferentes productos de Deque. Su administrador puede permitir que ciertos ajustes sean modificados por los usuarios.

Token de identidad

Un Token de Identidad es un token de seguridad emitido por JFrog que le permite acceder al repositorio de artefactos Agora de Deque. Los Tokens de Identidad deben copiarse en el momento de su creación, ya que esta es la única oportunidad para acceder a ellos. Expiran después de un intervalo de tiempo designado, típicamente un año.

Impacto

Cada violación de accesibilidad se asigna un nivel de impacto. El impacto es una métrica útil al priorizar los esfuerzos de remediación. Por defecto, a cada tipo de violación se le asigna un nivel de impacto por los expertos en accesibilidad de Deque. Estos valores están generalizados para la mayoría de las situaciones, por lo que los usuarios pueden usar su juicio para cambiarlos como parte de la personalización de su conjunto de reglas. Los niveles de impacto serio o crítico se correlacionan con usuarios con discapacidad que encuentran barreras de uso significativas o insuperables. Estos conllevan el mayor grado de responsabilidad legal. Los problemas menores y moderados no son tan serios, pero aún representan asuntos importantes para los usuarios con discapacidad y requieren atención para que la página cumpla completamente. Se utilizan los siguientes cuatro niveles para categorizar el impacto de los problemas de accesibilidad detectados:

• Crítico: Este nivel de impacto significa que los usuarios con discapacidad estarán completamente bloqueados para acceder o interactuar con una característica en la página web. Hasta que se implemente una solución, el contenido será totalmente inaccesible. Esto hace que su organización sea altamente vulnerable a demandas legales. La remediación de problemas críticos debería ser una prioridad máxima.

• Serio: Este nivel de impacto significa que los usuarios con discapacidad enfrentarán barreras serias al interactuar con el sitio. Estos usuarios experimentarán una frustración significativa al intentar acceder al contenido relacionado. Hasta que se implemente una solución, algo de contenido será difícil o imposible de acceder, haciendo que su organización sea vulnerable a acciones legales. La remediación debería ser una alta prioridad.

• Moderado: Este nivel de impacto significa que existen algunas barreras para los usuarios con discapacidad, pero no les impedirían acceder a flujos o contenido básico. Los problemas con impacto en este nivel pueden hacer que su organización sea vulnerable a acciones legales. Requieren resolución antes de que una página sea completamente conforme, y deben ser remediados.

• Menor: Un problema que causa menos impacto para los usuarios discapacitados que un problema moderado. El problema puede constituir una prioridad más baja que los problemas moderados, serios y críticos, pero aún requiere resolución para que una página sea completamente conforme.

Incompleto

Un resultado incompleto significa que axe-core no pudo determinar con absoluta certeza si algo es una violación, por lo que una persona necesita inspeccionarlo. Debido a que axe-core busca cero falsos positivos, solo informa los problemas sobre los que está seguro como violaciones y registra todo lo incierto por separado. Incompleto y necesita revisión son dos nombres para el mismo tipo de resultado; cuál ve depende del componente de Axe DevTools que esté utilizando. Un resultado incompleto puede o no resultar ser un problema de accesibilidad.

Pruebas Guiadas Inteligentes (PGI)

Pruebas Guiadas Inteligentes (IGT) es un componente interactivo de pruebas de accesibilidad de las extensiones de navegador web de Axe DevTools diseñado para encontrar errores de accesibilidad que no pueden ser detectados en pruebas automatizadas. IGT hace preguntas simples al usuario sobre la página web bajo prueba y utiliza este feedback para localizar más errores de accesibilidad que de otra manera no serían posibles con pruebas automatizadas. Para aprender más sobre las Pruebas Guiadas Inteligentes, visita el Documentación de Pruebas Guiadas Inteligentes.

Problema

Una violación de las pautas de accesibilidad (como las definidas por estándares como WCAG 1.0, WCAG 2.0, Sección 508 y WAI-ARIA) identificada en el código de una página web o aplicación web.

Resultados de Accesibilidad JSON

Cuando pruebas un sitio web para problemas de accesibilidad utilizando las API o CLI de Axe DevTools, tus resultados se guardan como un archivo JSON que se denomina en la documentación como un archivo resultados de accesibilidad JSON. Puedes subir este archivo a Axe Reports (lo que te permite monitorear la accesibilidad de tu sitio web a lo largo del tiempo a través del sitio web de Axe Reports). También puedes filtrar y convertir el archivo de resultados de accesibilidad JSON localmente a .csv, .xml o .html usando la CLI. Consulta Informes con la CLI para más información. Alternativamente, las API también te permiten convertir archivos de resultados de accesibilidad JSON a reportes durante una prueba (consulta Informes a continuación para más información).

Modo Manual

Por defecto, Axe Developer Hub analiza automáticamente cada una de tus páginas web y vuelve a analizarlas cada vez que detecta un nuevo estado de la página. Puedes desactivar este comportamiento automático

• (JavaScript/TypeScript) Estableciendo la propiedad autoAnalyze en el objeto de configuración axe a false.
• (Java) Llamando al método setAutoAnalyze() con false.

También puede anular el comportamiento de análisis automático

• (JavaScript/TypeScript) Llamando al método stop().
• (Java) Llamando al método AxeWatcherController.stop().

En cualquier caso, esto coloca a Watcher en modo manual. En modo manual, las páginas solo se analizan cuando se llama al método analyze().

Biblioteca de Métricas

Una biblioteca interna utilizada por las APIs y CLI de Deque para reportar información de uso al servicio de uso.

Suite de Pruebas Modificada

Un suite de pruebas modificada es un conjunto de pruebas que has cambiado según las instrucciones proporcionadas por Axe Developer Hub cuando creaste un nuevo proyecto. Modificar tu conjunto de pruebas te permite agregar pruebas de accesibilidad a tu conjunto de pruebas existente con mínimos cambios en el propio conjunto de pruebas.

Necesita Revisión

Un problema requiere la inspección de una persona para determinar si realmente es una violación de los estándares de accesibilidad. Necesita revisión significa lo mismo que incompleto: axe-core no pudo determinar con absoluta certeza si el problema es una violación. Si es nuevo en el testeo de accesibilidad o está trabajando en un sitio con muchos problemas conocidos, aborde primero las violaciones. Cuando llegue a los resultados que necesitan revisión, consulte con un experto en accesibilidad digital antes de decidir si corregirlos o ignorarlos.

Estado de la Página

El estado de la página de una página web se refiere al estado de su modelo de objetos del documento (DOM) en un momento específico. Los estados de las páginas son útiles para sitios web complejos con pantallas de inicio de sesión o interfaces de usuario dinámicas como las aplicaciones de una sola página (SPA). Ejemplos de estado del DOM incluyen:

• La visibilidad de los elementos
• El contenido de los elementos
• El estado seleccionado de los botones de radio y las casillas de verificación

El paquete Watcher vuelve a escanear las páginas web cuando detecta cambios en el DOM y guarda un nuevo estado de la página cada vez.

Proyecto

Un proyecto en Axe Developer Hub contiene resultados de accesibilidad, información de ejecución de pruebas y datos de Git (ramas y commits). La asociación entre esta información y el proyecto se realiza a través del ID del proyecto del proyecto. Cuando creas y nombras un nuevo proyecto en Axe Developer Hub, se genera un ID de proyecto que utilizas con tus pruebas para identificar el proyecto.

Informes

El reporte se refiere a subir un archivo resultados de accesibilidad JSON a Axe Reports o convertirlo localmente a un reporte (un archivo .csv, .xml o .html) para su uso en otra aplicación.

RGAA

RGAA, o Référentiel Général d'Amélioration de l'Accessibilité, es el estándar de accesibilidad web del gobierno francés. Está en gran medida basado en WCAG 2.1 y proporciona criterios técnicos específicos para evaluar la accesibilidad del contenido web. La versión actualmente soportada es RGAA 4, identificada por el ID del conjunto de reglas rgaav4.

Regla

Una regla corresponde a un criterio de éxito de una guía de accesibilidad. Están definidas por archivos de objetos JSON y contienen un id, una descripción y metadatos de ayuda así como uno o más chequeos y parámetros opcionales.

Sección 508

Una enmienda al Acta de Rehabilitación de 1973 de los Estados Unidos que requiere que las agencias federales hagan su tecnología electrónica e informativa accesible a las personas con discapacidades. Comprende dieciséis disposiciones basadas en las guías de accesibilidad desarrolladas por las Guías de Accesibilidad de Contenido Web (WCAG) desarrolladas por el Consorcio World Wide Web (W3C) pero no son idénticas a los estándares WCAG 1.0 o 2.0.

SHA

Cuando creas un commit en Git, se genera un ID que identifica de manera única al commit. El ID único se llama SHA (un acrónimo de Secure Hash Algorithms, un grupo de funciones hash criptográficas).

Servicio de Uso

Un servicio web REST que registra métricas de uso de Axe DevTools para Web (APIs y CLI). Es ya sea el servicio público proporcionado por Deque o tu propio servicio. Para más información, consulta El Servicio de Uso de Axe DevTools para Web.

Violación

Un problema identificado por Axe DevTools que viola uno o más estándares de accesibilidad.

Watcher

El componente de código que integras en tu conjunto de pruebas se llama Watcher. Deque ofrece varias ediciones del paquete para los lenguajes y marcos de prueba soportados. Integras el paquete del Watcher en el conjunto de pruebas de tu sitio web para analizar las páginas web e informar los resultados a Axe Developer Hub, donde puedes ver los resultados. El paquete del Watcher también escanea el commit y la rama actual de Git y asocia las ejecuciones de prueba con estos.

WCAG

WCAG, o Guías de Accesibilidad para el Contenido Web, fueron desarrolladas por el Consorcio World Wide Web (W3C) y explican cómo hacer el contenido web más accesible para las personas con discapacidades. WCAG 1.0 se publicó en mayo de 1999. WCAG 2.0 se publicó en diciembre de 2008. WCAG 2.0 se aplica ampliamente a tecnologías más avanzadas y es más preciso de probar con evaluaciones automáticas y evaluación humana. WCAG 2.1 se publicó en junio de 2018. Estas guías contienen criterios de éxito que definen criterios verificables para elementos específicos. WCAG 2.2, la iteración más reciente de las guías, se publicó en 2023 y ofrece nueve nuevos criterios de éxito sobre WCAG 2.1.

Encapsulamiento

Encapsulamiento se refiere a modificar una plataforma de automatización de navegadores (como Cypress) para llamar al código de prueba de accesibilidad (en el paquete Watcher) cada vez que se llama a una función de la plataforma de automatización de navegadores. El encapsulamiento te permite integrar pruebas de accesibilidad en tus suites de pruebas existentes con cambios mínimos en tu código.