CKTIS / JavaScript
String.prototype.toUpperCase() — letters omzetten naar hoofdletters
De methode toUpperCase() geeft tekst terug waarvan de letters volgens de standaardregels voor Unicode naar hoofdletters zijn omgezet. De oorspronkelijke tekst blijft ongewijzigd, de methode heeft geen argumenten nodig en de lengte van het resultaat kan veranderen.
Versie: 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() geeft een waarde van het type string terug waarin letters volgens het standaardalgoritme van Unicode naar hoofdletters zijn omgezet. Roep de methode aan als string.toUpperCase(), zonder argumenten. De oorspronkelijke tekst blijft ongewijzigd; bewaar of geef de geretourneerde waarde door om de omgezette tekst te gebruiken.
De omzetting is niet beperkt tot ASCII. Eén codepunt kan in meerdere veranderen, waardoor de lengte van het resultaat kan veranderen: ß wordt SS. De cijfers en leestekens in het voorbeeld blijven ongewijzigd. Een omzetting naar hoofdletters en daarna naar kleine letters herstelt de oorspronkelijke tekst niet noodzakelijk.
De methode houdt geen rekening met een geselecteerde taal of landinstelling. Als taalafhankelijke regels voor hoofdletters nodig zijn, kun je toLocaleUpperCase() overwegen. Op zichzelf is toUpperCase() geen algemene methode om tekst hoofdletterongevoelig te vergelijken.
Met String.prototype.toUpperCase.call(value) kun je de methode ook aanroepen met value als ontvanger. Bij null en undefined geeft de methode al vóór de omzetting een TypeError. In andere gevallen gebruikt ze de bewerking ToString, die bij een primitieve waarde van het type Symbol een TypeError geeft. De methode hoort bij de ECMAScript-standaardbibliotheek, niet bij de DOM; de taalspecificatie is geen compatibiliteitstabel voor browsers.
Voorbeelden
const original = "Straße 123!";
const upper = original.toUpperCase();
console.log(original);
console.log(upper);
console.log(original.length, upper.length);Resultaat
Straße 123! STRASSE 123! 11 12
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.