CKTIS / JavaScript
String.prototype.endsWith — ein String-Ende prüfen
String.prototype.endsWith prüft, ob ein String mit einem bestimmten Text endet, und gibt true oder false zurück. Die Methode unterscheidet Groß- und Kleinschreibung, verändert den String nicht und ermöglicht eine frühere Endposition für die Prüfung.
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
str.endsWith(searchString[, endPosition])String.prototype.endsWith vergleicht searchString mit dem Ende eines Strings und gibt true oder false zurück, ohne das Original zu verändern. Beim Vergleich wird zwischen Groß- und Kleinschreibung unterschieden; er arbeitet mit UTF-16-Codeeinheiten und führt keine Unicode-Normalisierung durch. Dies ist eine Methode der ECMAScript-Standardbibliothek und keine Browser-API.
Der optionale Parameter endPosition legt eine exklusive Endgrenze fest: Geprüft wird das Ende des Präfixes bis zu dieser Grenze, nicht ein Teilstring, der dort beginnt. Wird das Argument weggelassen oder undefined übergeben, wird die gesamte Länge verwendet. Nach der Umwandlung in eine Ganzzahl wird der Wert auf den Bereich von 0 bis zur Stringlänge begrenzt; negative Werte zählen nicht vom Ende zurück. Positionen werden in UTF-16-Codeeinheiten gemessen.
Bei leerem searchString gibt die Methode auch an der Grenze 0 den Wert true zurück, sofern eine gegebenenfalls nötige Umwandlung von endPosition gelingt. Die Umwandlung erfolgt vor dem Vergleich: Wird 0n als endPosition übergeben, löst das auch bei leerem searchString einen TypeError aus. Das Argument searchString wird in einen String umgewandelt. Wird es weggelassen, wird daher der Text "undefined" verwendet. Ein Argument, das als regulärer Ausdruck erkannt wird, löst einen TypeError aus. Auch ein Aufruf der Methode mit null oder undefined als this löst einen TypeError aus.
Im Beispiel liegt die Grenze 10 direkt hinter report.txt. Deshalb ergibt die Prüfung auf .txt den Wert true, obwohl der ganze String mit .bak endet. Die Prüfung auf .BAK ergibt wegen der unterschiedlichen Groß- und Kleinschreibung false.
Beispiele
const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));Ergebnis
true true false true
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.