La méthode toLocaleLowerCase()
renvoie la chaîne de caractères qui appelle la méthode en une chaîne de caractères représentées en minuscules, en tenant compte des correspondances de caractères propres aux différentes locales.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
str.toLocaleLowerCase() str.toLocaleLowerCase(locale) str.toLocaleLowerCase([locale, locale, ...])
Paramètres
locale
Facultatif- Ce paramètre indique la locale dans laquelle convertir la chaîne en minuscules en utilisant les correspondances de cette locale. Si plusieurs locales sont fournies au sein d'un tableau, c'est la meilleure locale disponible qui est utilisée. La locale par défaut est celle utilisée par le système hôte.
Valeur de retour
Une nouvelle chaîne de caractères obtenue à partir de la chaîne appelante, convertie en minuscules en tenant compte de la locale.
Exceptions
Cette méthode peut lever les exceptions suivantes :
RangeError
("invalid language tag: xx_yy") si l'argumentlocale
ne correspond pas à une balise de langue valide.TypeError
("invalid element in locales argument") si un des éléments du tableau passé en argument n'est pas une chaîne de caractères.
Description
La méthode toLocaleLowerCase()
renvoie la valeur de la chaîne de caractères, convertie en minuscules selon les correspondances propres à la la locale. toLocaleLowerCase()
ne modifie pas la chaîne d'origine. Dans la plupart des cas, cette méthode produira le même résultat que toLowerCase()
. En revanche, pour certaines locales, par exemple les locales turques dont les correspondances entre les caractères ne sont pas celles par défaut, prévues par Unicode, cette méthode pourra produire un résultat différent.
Exemples
"ALPHABET".toLocaleLowerCase(); // "alphabet"
"\u0130".toLocaleLowerCase("tr") === "i"; // true
"\u0130".toLocaleLowerCase("en-US") === "i"; // false
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) La définition de 'String.prototype.toLocaleLowerCase' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'String.prototype.toLocaleLowerCase' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'String.prototype.toLocaleLowerCase' dans cette spécification. |
Standard évolutif | |
ECMAScript Internationalization API (ECMA-402) La définition de 'String.prototype.toLocaleLowerCase' dans cette spécification. |
Standard évolutif | Ajout du paramètre locale dans ES Intl 2017 |
Compatibilité des navigateurs
BCD tables only load in the browser
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.