KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.toLowerCase() — omzetten naar kleine letters

De methode toLowerCase() geeft een tekenreeks terug die volgens Unicode-regels naar kleine letters is omgezet, zonder het origineel te wijzigen. De methode accepteert geen parameters en past het resultaat niet aan de taal van de gebruiker aan.

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.toLowerCase()

String.prototype.toLowerCase() geeft een tekenreeks terug waarvan de letters volgens de standaard Unicode-regels voor hoofdletterconversie naar kleine letters zijn omgezet. Roep de methode zonder argumenten aan als string.toLowerCase(). De oorspronkelijke tekenreeks blijft ongewijzigd; wijs het resultaat aan een variabele toe om het te bewaren.

De conversie is niet afhankelijk van de locale, maar kan wel afhangen van de omringende tekens. Beschouw deze methode niet als een universele regel voor het vergelijken van tekst zonder onderscheid tussen hoofdletters en kleine letters. Omzetten naar hoofdletters en daarna naar kleine letters levert niet noodzakelijk hetzelfde resultaat op als toLowerCase() rechtstreeks aanroepen.

Eén teken kan overeenkomen met meerdere codepunten, waardoor de lengte van het resultaat kan veranderen. In het voorbeeld wordt \u0130 de reeks i\u0307, waarvan de length-waarde 2 is.

De methode is generiek: wanneer je haar aanroept via String.prototype.toLowerCase.call(value), wijst ze eerst null en undefined af met een TypeError en zet ze daarna andere waarden om naar een tekenreeks. Ook die conversie kan een fout veroorzaken.

Voorbeelden

const original = "HELLO ŁÓDŹ";
const lower = original.toLowerCase();
console.log(lower);
console.log(original);

const expanded = "\u0130".toLowerCase();
console.log(expanded === "i\u0307");
console.log(expanded.length);

Resultaat

hello łódź
HELLO ŁÓDŹ
true
2

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.

Bronnen