String.prototype.startsWith()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Die startsWith()-Methode der String-Werte bestimmt, ob dieser String mit den Zeichen eines angegebenen Strings beginnt und gibt entsprechend true oder false zurück.

Probieren Sie es aus

Syntax

js
startsWith(searchString)
startsWith(searchString, position)

Parameter

searchString

Die Zeichen, nach denen am Anfang dieses Strings gesucht werden soll. Kann kein Regex sein. Alle Werte, die keine Regexes sind, werden zu Strings umgewandelt, sodass das Weglassen oder Übergeben von undefined dazu führt, dass startsWith() nach dem String "undefined" sucht, was selten gewünscht ist.

position Optional

Die Startposition, an der searchString gefunden werden soll (der Index des ersten Zeichens von searchString). Standardmäßig 0.

Rückgabewert

true, wenn die angegebenen Zeichen am Anfang des Strings gefunden werden, einschließlich wenn searchString ein leerer String ist; andernfalls false.

Ausnahmen

TypeError

Wird ausgelöst, wenn searchString ein Regex ist.

Beschreibung

Mit dieser Methode können Sie feststellen, ob ein String mit einem anderen String beginnt. Diese Methode ist case-sensitiv.

Beispiele

Verwendung von startsWith()

js
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

Specification
ECMAScript Language Specification
# sec-string.prototype.startswith

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch