WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.toLowerCase() — Umwandlung in Kleinbuchstaben

Die Methode toLowerCase() gibt eine Zeichenfolge zurück, die nach Unicode-Regeln in Kleinbuchstaben umgewandelt wurde, ohne das Original zu ändern. Sie akzeptiert keine Parameter und passt das Ergebnis nicht an die Sprache der Nutzerin oder des Nutzers an.

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

String.prototype.toLowerCase() gibt eine Zeichenfolge zurück, deren Buchstaben gemäß den standardmäßigen Unicode-Regeln für die Groß-/Kleinschreibung in Kleinbuchstaben umgewandelt wurden. Rufe die Methode ohne Argumente als string.toLowerCase() auf. Die ursprüngliche Zeichenfolge bleibt unverändert; weise das Ergebnis einer Variablen zu, wenn du es behalten möchtest.

Die Umwandlung ist nicht von der Spracheinstellung abhängig, kann aber vom Kontext der Zeichen abhängen. Betrachte sie nicht als allgemeingültige Regel für den Vergleich von Texten ohne Beachtung der Groß- und Kleinschreibung. Eine Umwandlung in Großbuchstaben und anschließend in Kleinbuchstaben muss nicht dasselbe Ergebnis liefern wie ein direkter Aufruf von toLowerCase().

Ein Zeichen kann mehreren Codepoints entsprechen, daher kann sich die Länge des Ergebnisses ändern. Im Beispiel wird \u0130 zur Folge i\u0307, deren length den Wert 2 hat.

Die Methode ist generisch: Wird sie über String.prototype.toLowerCase.call(value) aufgerufen, weist sie zuerst null und undefined mit einem TypeError zurück und wandelt anschließend andere Werte in eine Zeichenfolge um. Auch diese Umwandlung kann einen Fehler auslösen.

Beispiele

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);

Ergebnis

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

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.

Quellen