String.prototype.toLocaleLowerCase()

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.

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'argument locale 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

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
toLocaleLowerCaseChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5.5Opera Support complet 4Safari Support complet 1.3WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0nodejs Support complet 0.1.100
localeChrome Support complet 58Edge Support complet 12Firefox Support complet 55IE Support complet 6Opera Support complet 45Safari Support complet 10WebView Android Support complet 58Chrome Android Support complet 58Firefox Android Support complet 55Opera Android Support complet 43Safari iOS Support complet 10Samsung Internet Android Support complet 7.0nodejs Support complet 13.0.0
Support complet 13.0.0
Support partiel 0.12
Notes
Notes Before version 13.0.0, only the locale data for en-US is available by default. When other locales are specified, the function silently falls back to en-US. To make full ICU (locale) data available for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.

Légende

Support complet  
Support complet
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir aussi