Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.toUpperCase() — convertir les lettres en majuscules

La méthode toUpperCase() renvoie un texte dont les lettres sont converties en majuscules selon les règles Unicode par défaut. Elle ne modifie pas l’original, ne prend aucun argument et peut changer la longueur du résultat.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

string.toUpperCase()

String.prototype.toUpperCase() renvoie une valeur de type string dont les lettres sont converties en majuscules selon l’algorithme Unicode par défaut. Appelez-la sous la forme string.toUpperCase(), sans argument. Le texte d’origine reste inchangé ; pour utiliser le texte converti, conservez ou transmettez la valeur renvoyée.

La conversion ne se limite pas à l’ASCII. Un point de code peut en devenir plusieurs, et la longueur du résultat peut donc changer : ß devient SS. Les chiffres et la ponctuation de l’exemple restent inchangés. Une conversion en majuscules puis en minuscules ne permet pas nécessairement de retrouver l’original.

La méthode ne tient pas compte d’une langue ou d’une région sélectionnée. Si vous avez besoin de règles de casse propres à une langue, envisagez toLocaleUpperCase(). À elle seule, toUpperCase() n’est pas un mécanisme général de comparaison de textes sans distinction de casse.

Vous pouvez aussi appeler la méthode avec value comme récepteur en utilisant String.prototype.toUpperCase.call(value). La méthode lève une TypeError pour null et undefined avant la conversion. Sinon, elle utilise l’opération ToString, qui lève une TypeError pour une valeur primitive de type Symbol. Elle fait partie de la bibliothèque standard ECMAScript, et non du DOM ; la spécification du langage n’est pas un tableau de compatibilité des navigateurs.

Exemples

const original = "Straße 123!";
const upper = original.toUpperCase();
console.log(original);
console.log(upper);
console.log(original.length, upper.length);

Résultat

Straße 123!
STRASSE 123!
11 12

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources