CKTIS / JavaScript
String.prototype.startsWith — einen Zeichenkettenpräfix prüfen
Die Methode startsWith prüft, ob eine Zeichenkette am Anfang oder genau an einer angegebenen Position ein bestimmtes Präfix hat. Sie gibt einen booleschen Wert zurück, unterscheidet Groß- und Kleinschreibung und verändert die Zeichenkette nicht.
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.startsWith(searchString[, position])String.prototype.startsWith gibt true zurück, wenn searchString genau am Index position passt; andernfalls gibt die Methode false zurück. Sie sucht nicht an späteren Positionen weiter und verändert die Zeichenkette nicht.
Der Standardwert für position ist 0. Der Wert wird in eine Ganzzahl umgewandelt, indem sein Nachkommateil gegen null abgeschnitten wird, und anschließend auf den Bereich von 0 bis zur Länge der Zeichenkette begrenzt; NaN bedeutet 0. Indizes zählen UTF-16-Codeeinheiten, nicht unbedingt vollständige, vom Nutzer wahrgenommene Zeichen.
Der Vergleich unterscheidet Groß- und Kleinschreibung und normalisiert Unicode nicht. Ein leeres searchString gibt true zurück, auch wenn die angegebene Position die Länge der Zeichenkette überschreitet. Andere Werte werden in Zeichenketten umgewandelt: Wird das Argument weggelassen, wird nach "undefined" gesucht. Ein gewöhnlicher regulärer Ausdruck verursacht einen TypeError.
Die Methode kann über call auch mit anderen Empfängern arbeiten und wandelt diese dabei in Zeichenketten um; ein Empfänger mit dem Wert null oder undefined verursacht jedoch einen TypeError. Dies ist eine ECMAScript-Sprach-API, keine DOM-API; die Spezifikation allein belegt nicht, dass sie in einem bestimmten Browser unterstützt wird.
Beispiele
const text = "Hello, world!";
console.log(text.startsWith("Hello"));
console.log(text.startsWith("hello"));
console.log(text.startsWith("world", 7));
console.log(text.startsWith("world", 6));
console.log(text.startsWith("", 99));Ergebnis
true false 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.