MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

String.prototype.toLocaleUpperCase()

La méthode toLocaleUpperCase() renvoie la chaîne de caractères qui appelle la méthode en caractères majuscules, selon les correspondances de caractères propres aux différentes locales.

Syntaxe

str.toLocaleUpperCase()
str.toLocaleUpperCase(locale) 
str.toLocaleUpperCase([locale, locale, ...])

Paramètres

locale Facultatif
Le paramètre locale indique la locale dans laquelle convertir la chaîne en majuscules afin que la méthode utilise les correspondances de cette locale. Si plusieurs locales sont fournies au sein d'un tableau, la meilleure locale disponible est alors 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 en transformant la chaîne de caractères appelante en majuscules et 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 arguments") si un élément du tableau de locales passé en argument n'est pas une chaîne de caractères.

Description

La méthode toLocaleUpperCase() renvoie la valeur de la chaîne de caractères, convertie en majuscules selon les correspondances propres à la la locale. toLocaleUpperCase() ne modifie pas la chaîne d'origine. Dans la plupart des cas, cette méthode produira le même résultat que toUpperCase(). 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évue par Unicode, cette méthode pourra produire un résultat différent.

Exemple

Utiliser la méthode toLocaleUpperCase()

"alphabet".toLocaleUpperCase(); // "ALPHABET"

"i\u0307".toLocaleUpperCase("lt-LT"); // "I"

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.toLocaleUpperCase' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'String.prototype.toLocaleUpperCase' dans cette spécification.
Standard  
ECMAScript Latest Draft (ECMA-262)
La définition de 'String.prototype.toLocaleUpperCase' dans cette spécification.
Projet  
ECMAScript Internationalization API 4.0 (ECMA-402)
La définition de 'String.prototype.toLocaleUpperCase' dans cette spécification.
Projet Ajout du paramètre locale dans ES Intl 2017.

Compatibilité des navigateurs

FonctionnalitéChromeFirefoxEdgeInternet ExplorerOperaSafari
Support simple(Oui)(Oui)(Oui)(Oui)(Oui)(Oui)
locale?55????
FonctionnalitéAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple(Oui)(Oui)(Oui)(Oui)(Oui)(Oui)(Oui)
locale???55???

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,