Volver al Centro de conocimiento
Plataforma

navigator.languages y localización: elegir el locale correcto

navigator.languages devuelve una lista ordenada de pistas de idioma. Aprende un orden de negociación que respeta la elección explícita y mantiene una reserva completa.

BotBrowser Team

Documentación

Quieres la documentación estructurada de Plataforma?

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.

Las preferencias de idioma del navegador pueden ayudar a elegir una primera traducción, pero son solo una pista. navigator.language indica la preferencia principal y navigator.languages puede ofrecer una lista ordenada. Ningún valor demuestra dónde vive una persona, su nacionalidad ni el idioma que quiere para cada tarea. La aplicación debe negociar un idioma compatible, mostrar un selector y conservar una alternativa legible.

La configuración de perfiles de BotBrowser puede establecer los idiomas y la locale del navegador, incluidos valores auto derivados del proxy, pero BotBrowser no traduce el contenido de la aplicación ni reemplaza una elección explícita dentro de ella. La pista del navegador puede influir en las entradas de negociación; la aplicación conserva el control sobre traducciones, consentimiento y reserva.

Resumen

navigator.language y navigator.languages son pistas de localización: ayudan a elegir un locale inicial, pero no prueban identidad ni ubicación. Negocia contra una lista de locales compatibles, mantén un control de idioma explícito en la aplicación por delante de la pista del navegador y ofrece siempre una experiencia predeterminada completa.

Contenido

Qué significan los valores de Navigator

La interfaz Navigator expone preferencias configuradas por la persona o por el navegador. MDN Navigator.language describe la etiqueta principal y WHATWG Navigator.languages describe la lista de preferencias. Una etiqueta como fr-CA expresa una preferencia lingüística y regional para el contenido, no una ubicación física.

La lista puede estar vacía, tener un solo elemento o cambiar después de un ajuste del navegador. Una aplicación debe tratarla como entrada para una selección temporal y no como un perfil permanente. El atributo lang del documento es distinto: ayuda a lectores de pantalla y debe actualizarse cuando cambia el idioma visible.

Negociar idiomas compatibles

Define una lista finita de locales realmente traducidos. Normaliza las etiquetas, prueba primero la coincidencia más específica y después el idioma padre. Si existen fr-CA, fr y en, una solicitud canadiense puede usar fr-CA, otra solicitud francesa puede usar fr y las demás pueden usar en. No inventes una traducción ni confundas una región con otra.

Un orden práctico es: elección explícita guardada, primer valor compatible de navigator.languages, navigator.language si la lista no está disponible y, por último, un idioma predeterminado estable. Esta secuencia funciona también en vistas integradas con menos información. El valor predeterminado debe ser una experiencia completa, no claves sin traducir.

La internacionalización distingue idioma, escritura y región. W3C Internationalization explica por qué esas partes de una etiqueta no son intercambiables. Si falta una variante, informa del idioma alternativo y ofrece el selector.

Para comparar etiquetas de forma estructurada, analiza y canoniza cada valor con Intl.Locale antes de compararlo con las locales compatibles. Un servidor también puede recibir la cabecera HTTP Accept-Language para elegir la respuesta inicial, pero es una preferencia, no una prueba de identidad o ubicación. Usa solo los datos necesarios y deja que una elección explícita guardada tenga prioridad; BotBrowser configura las entradas de idioma del navegador, pero no decide la política del servidor ni la locale final de la aplicación.

Mantener la elección de la persona

La selección automática sirve para la primera visita, pero nunca debe impedir leer la interfaz. El selector debe mostrar nombres traducidos, tener un valor actual claro y funcionar con teclado. Guarda el locale solo después de una elección explícita y restáuralo antes de consultar una nueva preferencia del navegador. Indica si la elección afecta la página, la cuenta o visitas futuras.

Durante la carga de recursos conserva el contenido y el foco. No borres formularios ni borradores al cambiar de idioma. Si falla un paquete, conserva el último idioma legible y ofrece reintentar. Una preferencia lingüística no es consentimiento para mensajes promocionales, transferencia de datos ni una decisión jurídica.

Cargar recursos sin perder contenido

Versiona los recursos y comprueba que cada clave necesaria existe. Durante una transición muestra el texto anterior en vez de una clave interna. Evita unir fragmentos de frases: el orden gramatical y las reglas de plural cambian entre idiomas. Usa Intl para fechas, números y listas, pero guarda los datos en forma canónica y no deduzcas país fiscal o moneda a partir del idioma.

Actualiza lang, títulos, descripciones, enlaces alternativos y dirección del documento. Prueba textos largos, escritura de derecha a izquierda y combinaciones de números y código. Las URL localizadas deben conservar la misma intención; una traducción ausente no debe enviar una URL válida a una página sin relación.

Probar preferencias, reserva y accesibilidad

Prueba una lista vacía, una región no compatible, una etiqueta con escritura y un navegador que solo expone navigator.language. Cambia la preferencia después de una elección explícita y comprueba que esta permanece. Borra la elección y verifica que la negociación vuelve a ser predecible.

Prueba red lenta, respuesta interrumpida y caché obsoleta. Conserva la entrada, anuncia el progreso y ofrece reintentar. Recorre el selector con teclado, comprueba el foco y verifica que el lector de pantalla recibe el nuevo lang. Revisa plurales, separadores decimales, expansión de texto y zoom.

Usa un conjunto fijo de aceptación para que un cambio de regla se pueda reproducir sin depender de la configuración personal del navegador de quien prueba. Fija la lista compatible en en, fr y fr-CA, y ejecuta cada fila con las preferencias del navegador y las elecciones guardadas que aporta el conjunto. Registra el locale seleccionado, la fuente de la decisión, la revisión del paquete cargado y el lang del documento tras el renderizado. El resultado esperado es el mismo en la respuesta del servidor y tras la hidratación: una diferencia es un fallo, aunque la página acabe mostrando un idioma legible.

Entrada del conjuntoSelección esperadaComprobación de aceptación
Cuenta guardada fr-CA; navegador enfr-CA desde la cuentaCambiar la entrada del navegador no sustituye la elección de la cuenta
Sin elección guardada; navegador fr-BE,enfr por reserva al padreEl selector nombra la reserva; el lang del documento es fr
Sin elección guardada; navegador deen por defectoEl paquete completo en inglés se carga sin claves sin traducir
Elección del dispositivo en; cuenta frfr con la sesión iniciadaCerrar sesión vuelve al en del dispositivo
Paquete fr-CA no disponiblePaquete completo en fr o enSin controles críticos mezclados; el reintento sigue disponible

Privacidad y límites

Las preferencias pueden contribuir a una configuración reconocible cuando se combinan con otros datos. Si solo necesitas un locale, no envíes la lista completa a analítica. No uses etiquetas para inferir residencia o un atributo sensible. Si existe una traducción remota, explica qué servicio recibe el texto, su retención y la acción que inicia la transferencia. La falta de un recurso local nunca debe subir contenido privado sin confirmación. El artículo sobre la traducción de páginas con Google Translate en BotBrowser trata la traducción de páginas desde el navegador.

Documenta qué locales están completos y cuáles usan una reserva. Mantén accesible la alternativa y revisa cualquier cambio de almacenamiento, sincronización o empaquetado.

Para fechas y números, separa la decisión de locale de los datos almacenados con la guía de formato Intl. Consulta también opciones de privacidad del navegador.

La misma regla se aplica a avisos, archivos generados y registros de soporte: cambia las etiquetas, no los datos ni los permisos.

Explica el alcance de cada selector y ofrece una reserva clara cuando falta un recurso.

Una etiqueta de idioma puede incluir escritura y región; esas partes deben conservarse al negociar.

La negociación debe ser determinista para que un informe de soporte pueda reproducirse sin guardar toda la lista del navegador.

La autenticación y la recuperación deben seguir siendo comprensibles si el paquete elegido aún no se cargó.

Las rutas renderizadas en servidor y cliente deben aplicar la misma prioridad a la elección guardada.

La calidad incluye títulos, etiquetas, avisos, texto alternativo y reglas de plural, no solo palabras traducidas.

Cuando falta una locale, ofrece elegir otra, continuar con el idioma predeterminado o reintentar.

Revisa la negociación si cambian los controles de privacidad, las vistas integradas o los datos de internacionalización.

El idioma predeterminado debe permitir leer y completar la tarea sin esperar otra descarga.

El cambio de idioma no debe borrar datos introducidos ni cambiar permisos ya concedidos.

Los mensajes de error también necesitan traducción o una alternativa comprensible.

Las fechas y cantidades almacenadas deben conservar su significado original.

La dirección del texto y el atributo lang forman parte de la accesibilidad.

Una preferencia del navegador no reemplaza una decisión consciente de compartir contenido.

Las preferencias del navegador se negocian con recursos compatibles y la elección explícita prevalece.

Mantén la elección comprensible en cada locale y explica cómo volver al idioma predeterminado, tanto en móvil como en escritorio.

La misma orientación se aplica a navegadores móviles y de escritorio.

Conclusión práctica

Trata los valores de idioma del navegador como una entrada más de un orden de negociación documentado: primero la elección explícita guardada, luego navigator.languages, después navigator.language y por último una experiencia predeterminada completa. Mantén el selector, la reserva y el estado de la tarea operativos en todos los locales compatibles, y vuelve a probar la ruta cuando cambien los controles de privacidad del navegador o el empaquetado de recursos. Documenta los locales compatibles para que una cadena ausente se diagnostique como un límite y no como un defecto.

Mapa de afirmaciones y fuentes

BotBrowser permite configurar los idiomas y la configuración regional del navegador, incluso con valores auto derivados del proxy, pero no traduce la aplicación y no sustituye la elección explícita de idioma; conserva un control de idioma y una alternativa dentro de la aplicación.

Fuentes públicas

#Navigator.language#Localización#Internacionalización#Accesibilidad

Este artículo forma parte de la guía: Superficies de la plataforma web: mapa de revisión

Ejecuta la misma comprobación en BotBrowser

Carga un perfil, mantén dentro del navegador las señales que acabas de leer y confirma el resultado en tu propia máquina antes del despliegue.