String.prototype.startsWith()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2015 browserübergreifend verfügbar.
Die Methode startsWith() von String-Werten bestimmt, ob eine Zeichenkette mit den Zeichen einer angegebenen Zeichenkette beginnt, und gibt entsprechend true oder false zurück.
Probieren Sie es aus
const str = "Saturday night plans";
console.log(str.startsWith("Sat"));
// Expected output: true
console.log(str.startsWith("Sat", 3));
// Expected output: false
Syntax
startsWith(searchString)
startsWith(searchString, position)
Parameter
searchString-
Die Zeichen, nach denen am Anfang dieser Zeichenkette gesucht wird. Der Wert darf kein regulärer Ausdruck sein. Alle Werte, die keine regulären Ausdrücke sind, werden in Zeichenketten umgewandelt. Wenn Sie den Parameter weglassen oder
undefinedübergeben, suchtstartsWith()daher nach der Zeichenkette"undefined", was selten beabsichtigt ist. positionOptional-
Die Startposition, an der
searchStringerwartet wird (der Index des ersten Zeichens vonsearchString). Der Standardwert ist0.
Rückgabewert
true, wenn die angegebenen Zeichen am Anfang der Zeichenkette stehen, auch wenn searchString eine leere Zeichenkette ist; andernfalls false.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
searchStringein regulärer Ausdruck ist.
Beschreibung
Mit dieser Methode können Sie feststellen, ob eine Zeichenkette mit einer anderen Zeichenkette beginnt. Die Methode unterscheidet zwischen Groß- und Kleinschreibung.
Beispiele
startsWith() verwenden
const str = "To be, or not to be, that is the question.";
console.log(str.startsWith("To be")); // true
console.log(str.startsWith("not to be")); // false
console.log(str.startsWith("not to be", 10)); // true
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.startswith |