WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.trimEnd() — nachgestellte Leerzeichen entfernen

trimEnd() gibt einen String ohne nachgestellte Leerraum- und Zeilenabschlusszeichen zurück. Besteht der String nur aus solchen Zeichen, ist das Ergebnis ein leerer String. Der ursprüngliche String bleibt unverändert.

Version: ECMAScript 2019. The main ECMAScript specification defines String.prototype.trimRight as a legacy alias whose initial value is the same function object as String.prototype.trimEnd.

Syntax

str.trimEnd()

String.prototype.trimEnd() entfernt die längste Folge von Leerraum- und Zeilenabschlusszeichen am Ende und gibt das Ergebnis als String-Wert zurück. Enthält der String Zeichen, die zu keiner dieser beiden Gruppen gehören, bleibt alles bis einschließlich des letzten solchen Zeichens unverändert. Strings sind unveränderlich: Speichere den zurückgegebenen Wert oder gib ihn weiter, um das Ergebnis zu verwenden. Besteht der String ausschließlich aus Zeichen, die die Methode entfernen kann, gibt sie einen leeren String zurück.

Die Methode nimmt keine Parameter entgegen, mit denen sich die zu entfernenden Zeichen festlegen lassen. Sie verwendet die ECMAScript-Mengen WhiteSpace und LineTerminator, zu denen unter anderem Leerzeichen, Tabulatoren, Zeilenabschlusszeichen und das geschützte Leerzeichen \u00A0 gehören. Beliebige unsichtbare Zeichen oder ein bestimmtes Suffix werden nicht entfernt. trimStart() wirkt am Anfang, trim() an beiden Enden.

Die Methode ist generisch. Bei einem Aufruf über call löst sie für null oder undefined als Empfänger noch vor der Umwandlung in einen String einen TypeError aus. Auf andere Empfängerwerte wendet sie ToString an. Bei einem primitiven Wert vom Typ Symbol löst diese Operation ebenfalls einen TypeError aus.

trimEnd() gehört zu ECMAScript 2019, nicht zu den Web APIs. Die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle. Prüfe die Verfügbarkeit in der Zielumgebung, zum Beispiel mit typeof String.prototype.trimEnd === "function". Die Verwendung von Node 24 in einem Repository allein belegt keine Browser-Unterstützung.

Beispiele

const original = "  Ada Lovelace \t\n";
const result = original.trimEnd();

console.log(JSON.stringify(result));
console.log(result.length);
console.log(original.length);

Ergebnis

"  Ada Lovelace"
14
17

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