CKTIS / JavaScript
String.prototype.toUpperCase() — Buchstaben in Großbuchstaben umwandeln
Die Methode toUpperCase() gibt einen Text zurück, dessen Buchstaben nach den standardmäßigen Unicode-Regeln in Großbuchstaben umgewandelt wurden. Das Original bleibt unverändert, die Methode benötigt keine Argumente und die Länge des Ergebnisses kann sich ändern.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.toUpperCase()String.prototype.toUpperCase() gibt einen string-Wert zurück, in dem Buchstaben nach dem standardmäßigen Unicode-Algorithmus in Großbuchstaben umgewandelt wurden. Rufe die Methode ohne Argumente als string.toUpperCase() auf. Der ursprüngliche Text bleibt unverändert. Um den umgewandelten Text zu verwenden, speichere den Rückgabewert oder gib ihn weiter.
Die Umwandlung ist nicht auf ASCII beschränkt. Ein Codepunkt kann zu mehreren werden, daher kann sich die Länge des Ergebnisses ändern: ß wird zu SS. Die Ziffern und Satzzeichen im Beispiel bleiben unverändert. Eine Umwandlung in Groß- und anschließend in Kleinbuchstaben stellt den ursprünglichen Text nicht unbedingt wieder her.
Die Methode berücksichtigt keine ausgewählte Sprache oder Gebietsschemaeinstellung. Wenn sprachspezifische Regeln für die Großschreibung benötigt werden, ziehe toLocaleUpperCase() in Betracht. toUpperCase() allein ist kein allgemeiner Mechanismus für einen Vergleich von Texten ohne Beachtung der Groß- und Kleinschreibung.
Mit String.prototype.toUpperCase.call(value) kannst du die Methode auch mit value als Empfänger aufrufen. Bei null und undefined löst die Methode bereits vor der Umwandlung einen TypeError aus. Andernfalls verwendet sie die Operation ToString, die bei einem primitiven Symbol-Wert einen TypeError auslöst. Sie gehört zur ECMAScript-Standardbibliothek und nicht zum DOM; die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle.
Beispiele
const original = "Straße 123!";
const upper = original.toUpperCase();
console.log(original);
console.log(upper);
console.log(original.length, upper.length);Ergebnis
Straße 123! STRASSE 123! 11 12
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.