Keyboard Layout API, preferencias regionales y privacidad
Usa el mapa del teclado para etiquetas accesibles sin convertirlo en una señal de teclas o identidad.
BotBrowser Team
Quieres la documentación estructurada de Huella digital?
Este artículo forma parte de la biblioteca editorial. Para pasos de configuración, material de referencia y actualizaciones continuas, entra en la sección de docs.
La especificación WICG Keyboard Map y las reglas del contexto seguro del navegador delimitan qué información de la distribución puede exponerse. BotBrowser puede validar de forma repetible una interfaz sensible a la distribución en un perfil controlado entre sistemas compatibles, pero no captura teclas, no infiere identidad y no garantiza que cada host proporcione un mapa. Esa frontera evita convertir una etiqueta útil en una señal de identidad.
Resumen
Keyboard Layout API puede ayudar a mostrar atajos según la distribución activa. Es una ayuda de presentación, no un registrador de teclas ni una prueba de nacionalidad o identidad. Pide el mapa solo para una tarea clara, conserva una alternativa y acepta que puede no estar disponible.
Contenido
- Para qué sirve el mapa
- Permisos, políticas y privacidad
- Etiquetas accesibles y alternativa
- Regla de decisión comprobable
- Conclusión
Para qué sirve el mapa
navigator.keyboard.getLayoutMap() relaciona códigos físicos con los caracteres habituales de la distribución activa. Un panel de ayuda puede mostrar el atajo que la persona verá en su teclado. El mapa no contiene un historial de teclas y leerlo no permite interceptar entradas.
Mantén el propósito limitado. Un editor puede explicar “Deshacer”; no debe convertir la distribución en un campo de perfil. Las personas pueden cambiarla, compartir el equipo o usarla temporalmente para otro idioma.
Permisos, políticas y privacidad
El soporte depende del navegador, del contexto seguro y de decisiones de permisos o políticas. Una solicitud rechazada significa que esta etiqueta no está disponible, no que el dispositivo tenga una identidad sospechosa. No envíes el mapa a un servidor si puedes usarlo localmente.
El mapa no sustituye las reglas para escuchar atajos. Explica el comando, evita recopilar texto y ofrece una acción con puntero. Si un diagnóstico necesita registrar algo, conserva solo el resultado necesario y su finalidad.
Etiquetas accesibles y alternativa
Conserva el nombre estable del comando y una alternativa sin teclado. Si el mapa resuelve la tecla, añade una etiqueta localizada; el texto para lectores de pantalla debe incluir el comando y los modificadores. Si no está disponible, usa una etiqueta predeterminada o una preferencia editable.
Prueba textos largos, idiomas de derecha a izquierda y cambios de distribución durante la tarea. El control debe seguir funcionando mientras aparece un aviso de permiso.
Regla de decisión comprobable
- Empieza con el nombre del comando y una acción alternativa.
- En un contexto seguro, solicita el mapa solo al abrir la ayuda de atajos.
- Si se resuelve, muestra la etiqueta local y no la guardes como identidad.
- Si falla, conserva la alternativa y registra solo el resultado de producto necesario.
El resultado esperado es concreto: la persona puede descubrir y activar “Deshacer” con o sin mapa; ninguna prueba necesita capturar teclas ni inferir nacionalidad.
Conclusión
El mapa mejora la claridad entre idiomas y teclados, pero debe seguir siendo una entrada de presentación acotada. BotBrowser puede revisar una interfaz en perfiles controlados entre sistemas compatibles; no captura teclas ni garantiza un mapa en cada host.
Consulta la especificación Keyboard Map, MDN Keyboard API, la guía de perfiles multiplataforma, la guía de formato locale y la guía de zona horaria y lengua.
Fuentes públicas
Artículos Relacionados
Lleva BotBrowser de la investigación a producción
Usa estas guías para entender el modelo y después avanzar hacia validación multiplataforma, contextos aislados y despliegue de navegador preparado para escalar.