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 von String
Werten bestimmt, ob dieser String mit den Zeichen eines angegebenen Strings beginnt und gibt entsprechend true
oder false
zurück.
Probieren Sie es aus
const str1 = "Saturday night plans";
console.log(str1.startsWith("Sat"));
// Expected output: true
console.log(str1.startsWith("Sat", 3));
// Expected output: false
Syntax
startsWith(searchString)
startsWith(searchString, position)
Parameter
searchString
-
Die Zeichen, nach denen am Beginn dieses Strings gesucht wird. Kann kein Regex sein. Alle Werte, die keine Regex sind, werden in Strings umgewandelt. Das Weglassen oder Übergeben von
undefined
führt dazu, dassstartsWith()
nach dem String"undefined"
sucht, was selten gewünscht wird. position
Optional-
Die Startposition, an der
searchString
gefunden werden soll (der Index des ersten Zeichens vonsearchString
). Standardmäßig0
.
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
Diese Methode ermöglicht es Ihnen zu bestimmen, ob ein String mit einem anderen String beginnt. Diese Methode ist groß- und kleinschreibungssensitiv.
Beispiele
Verwendung von startsWith()
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® 2026 Language Specification # sec-string.prototype.startswith |