Retour au Centre de connaissances
Plateforme

navigator.languages et localisation : choisir la bonne locale

navigator.languages renvoie une liste ordonnée d'indices de langue. Apprenez un ordre de négociation qui respecte le choix explicite et conserve un repli complet.

BotBrowser Team

Documentation

Vous voulez la documentation structurée pour Plateforme ?

Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.

Les préférences de langue du navigateur peuvent aider à choisir une première traduction, mais elles restent un indice. navigator.language indique la préférence principale et navigator.languages peut fournir une liste ordonnée. Ces valeurs ne prouvent ni le lieu de vie, ni la nationalité, ni la langue souhaitée pour chaque tâche. Une application négocie une langue disponible, propose un sélecteur et garde un repli lisible.

Les réglages de profil BotBrowser peuvent définir les langues et la locale du navigateur, y compris les valeurs auto déduites du proxy, mais BotBrowser ne traduit pas le contenu de l'application et ne remplace pas un choix explicite. L'indice du navigateur peut alimenter la négociation ; l'application garde la maîtrise des traductions, du consentement et du repli.

Résumé

navigator.language et navigator.languages sont des indices de localisation : ils aident à choisir une locale initiale, mais ne prouvent ni identité ni localisation. Négociez avec une liste de locales prises en charge, faites passer le contrôle explicite de la langue dans l'application avant l'indice du navigateur et fournissez toujours une expérience par défaut complète.

Sommaire

Signification des valeurs Navigator

L'interface Navigator expose des préférences définies par la personne ou le navigateur. MDN Navigator.language décrit la balise principale et WHATWG Navigator.languages décrit la liste ordonnée. fr-CA exprime une préférence linguistique et régionale pour le contenu, pas une position géographique.

La liste peut être absente, unique ou changer après une modification des réglages. Traitez-la comme une entrée de sélection et non comme un profil permanent. L'attribut lang du document est différent : il aide les lecteurs d'écran et doit être actualisé lorsque le contenu visible change.

Négocier les langues disponibles

Définissez la liste des locales réellement traduites. Normalisez les balises, essayez la variante la plus précise, puis la langue parente. Avec fr-CA, fr et en, une demande canadienne peut utiliser fr-CA, une autre demande française fr, et le reste en. Ne fabriquez pas de traduction et ne confondez pas les régions.

Un ordre fiable est le choix explicite mémorisé, la première valeur compatible de navigator.languages, navigator.language si la liste manque, puis une langue par défaut stable. Cette séquence convient aussi aux vues intégrées qui fournissent moins d'informations. Le défaut doit rester complet, sans clés non traduites.

L'internationalisation distingue langue, écriture et région. W3C Internationalization explique pourquoi ces éléments ne sont pas interchangeables. Si une variante manque, indiquez le repli et laissez une autre langue accessible dans le sélecteur.

Pour comparer les balises, analysez-les et canonisez-les avec Intl.Locale avant de les confronter aux locales prises en charge. Un serveur peut aussi recevoir l'en-tête HTTP Accept-Language pour la première réponse, mais il s'agit d'une préférence, pas d'une preuve d'identité ou de lieu. Limitez les données à ce qui est nécessaire et faites primer un choix explicite mémorisé ; BotBrowser règle les entrées de langue du navigateur, sans décider de la politique serveur ni de la locale finale de l'application.

Préserver le choix explicite

La sélection automatique aide lors de la première visite, mais ne doit jamais enfermer une personne dans une langue illisible. Le sélecteur doit afficher des noms traduits, une valeur courante claire et un parcours au clavier. Mémorisez la locale après un choix explicite et restaurez-la avant de consulter une préférence navigateur modifiée. Précisez si le choix concerne la page, le compte ou les prochaines visites.

Gardez le contenu et le focus pendant le chargement. Ne supprimez ni formulaire ni brouillon lors du changement. Si un paquet échoue, conservez la dernière langue lisible et proposez une nouvelle tentative. Une préférence ne vaut pas consentement pour les messages promotionnels, le transfert de données ou une décision juridique.

Charger les ressources sans casser le contenu

Versionnez les ressources et vérifiez chaque clé nécessaire. Pendant la transition, affichez l'ancien texte plutôt qu'une clé interne. Évitez de concaténer des fragments : l'ordre grammatical et les pluriels varient. Utilisez Intl pour les dates, nombres et listes, mais stockez les données de façon canonique et ne déduisez pas le pays fiscal à partir de la langue.

Mettez à jour lang, les titres, descriptions, liens alternatifs et la direction du document. Testez les textes longs, le sens droite-gauche et les nombres mêlés au code. Une URL localisée doit garder la même intention ; une traduction absente ne doit pas rediriger vers une page sans rapport.

Tester préférence, repli et accessibilité

Testez une liste vide, une région non prise en charge, une balise avec écriture et un navigateur qui ne fournit que navigator.language. Modifiez la préférence après un choix explicite et vérifiez que celui-ci reste prioritaire. Effacez ce choix et vérifiez que la négociation redevient prévisible.

Testez une connexion lente, une réponse interrompue et un cache périmé. Conservez les saisies, annoncez la progression et proposez une reprise. Parcourez le sélecteur au clavier, vérifiez le focus et le nouvel attribut lang avec un lecteur d'écran. Contrôlez pluriels, séparateurs décimaux, expansion du texte et zoom.

Utilisez un jeu de tests figé pour qu’une modification de règle reste reproductible sans dépendre des réglages personnels du testeur. Fixez la liste prise en charge à en, fr et fr-CA, puis exécutez chaque ligne avec les préférences de navigateur et les choix enregistrés fournis par le jeu. Relevez la locale retenue, sa source de décision, la révision du paquet chargé et l’attribut lang du document après le rendu. Le résultat attendu est identique dans la réponse du serveur et après l’hydratation ; un écart est un échec même si la page finit par afficher une langue lisible.

Entrée du testSélection attendueContrôle d’acceptation
Compte enregistré fr-CA ; navigateur enfr-CA issu du compteChanger la préférence du navigateur ne remplace pas le choix du compte
Aucun choix enregistré ; navigateur fr-BE,enrepli parent frLe sélecteur nomme le repli ; lang du document vaut fr
Aucun choix enregistré ; navigateur dedéfaut enLe paquet anglais complet se charge sans clés brutes
Choix de l’appareil en ; compte frfr une fois connectéLa déconnexion revient à en pour l’appareil
Paquet fr-CA indisponiblepaquet fr ou en completAucun contrôle critique mixte ; la reprise reste disponible

Après chaque cas, modifiez la préférence du navigateur, rechargez la page et répétez la sélection. Effacez le choix enregistré et vérifiez que la sélection suivante provient du navigateur. Une fois un paquet complet chargé, testez le mode hors connexion puis demandez une locale indisponible : la page doit conserver la langue en cache, préserver les valeurs du formulaire et proposer une nouvelle tentative. Enfin, changez la langue uniquement au clavier et vérifiez que le focus reste sur une commande pertinente. Conservez ces entrées et résultats avec la révision des ressources, sans en faire un enregistrement analytique associé à la liste complète des langues d’une personne.

Vie privée et limites

Les préférences peuvent contribuer à une configuration reconnaissable lorsqu'elles sont combinées à d'autres données. Si seule la locale est nécessaire, n'envoyez pas toute la liste aux outils d'analyse. N'utilisez pas ces balises pour déduire résidence ou attribut sensible. Pour une traduction distante, indiquez le service, la conservation et l'action qui déclenche le transfert. Un manque local ne doit jamais téléverser un contenu privé sans confirmation. L'article sur la façon de traduire des pages avec Google Translate dans BotBrowser traite de la traduction de pages côté navigateur.

Documentez les locales complètes et celles qui utilisent un repli. Gardez l'alternative accessible et réévaluez tout changement de stockage, synchronisation ou empaquetage.

Pour les dates et les nombres, séparez la locale des données stockées avec le guide de formatage Intl. Consultez aussi les choix de confidentialité du navigateur.

La même règle concerne les alertes, les fichiers générés et le support : changez les libellés, pas les données ni les autorisations.

Expliquez la portée de chaque sélecteur et affichez un repli clair lorsqu'une ressource manque.

Une balise peut contenir une écriture et une région ; ces parties doivent rester distinctes.

La négociation doit être déterministe afin qu'un support puisse reproduire un résultat sans conserver toute la liste du navigateur.

L'authentification et la récupération doivent rester compréhensibles si le paquet choisi n'est pas encore chargé.

Les routes rendues côté serveur et côté client doivent appliquer la même priorité au choix mémorisé.

La qualité comprend titres, libellés, alertes, textes alternatifs et pluriels, pas seulement les mots traduits.

Quand une locale manque, proposez une autre langue, le défaut ou une nouvelle tentative.

Réévaluez la négociation si changent les contrôles de confidentialité, les vues intégrées ou les données internationales.

La langue par défaut doit permettre de terminer la tâche sans attendre une autre ressource.

Un changement de langue ne doit effacer ni saisie ni autorisation déjà accordée.

Les messages d'erreur ont besoin d'une traduction ou d'un repli compréhensible.

Les dates et montants stockés doivent conserver leur sens original.

La direction du texte et l'attribut lang font partie de l'accessibilité.

Une préférence du navigateur ne remplace jamais un choix conscient de partager du contenu.

Les préférences du navigateur sont négociées avec les ressources disponibles et le choix explicite prévaut.

Gardez le choix compréhensible dans chaque locale et expliquez comment revenir à la langue par défaut, sur mobile comme sur ordinateur.

Les mêmes conseils s'appliquent aux navigateurs mobiles et de bureau.

Conclusion pratique

Traitez les valeurs de langue du navigateur comme une entrée d'un ordre de négociation documenté : d'abord le choix explicite enregistré, puis navigator.languages, ensuite navigator.language, enfin une expérience par défaut complète. Gardez le sélecteur, le repli et l'état de la tâche utilisables dans chaque locale prise en charge, et retestez le parcours quand les contrôles de confidentialité du navigateur ou l'empaquetage des ressources changent. Documentez les locales prises en charge pour qu'une chaîne manquante soit diagnostiquée comme une limite et non comme un défaut.

Correspondance des affirmations et sources

BotBrowser permet de définir les langues et la locale du navigateur, y compris les valeurs auto déduites du proxy, mais ne traduit pas l’application et ne remplace pas le choix explicite de langue ; gardez un contrôle de langue et une solution de repli dans l’application.

Sources publiques

#Navigator.language#Localisation#Internationalisation#Accessibilité

Cet article fait partie du guide : Surfaces de la plateforme web : carte de revue

Exécutez la même vérification dans BotBrowser

Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.