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 Methode startsWith() 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

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 Regexe sind, werden in Strings umgewandelt, daher führt das Weglassen oder Übergeben von undefined dazu, dass startsWith() nach dem String "undefined" sucht, was selten gewünscht ist.

position Optional

Die Startposition, an der searchString erwartet wird (der Index des ersten Zeichens von searchString). Der Standardwert ist 0.

Rückgabewert

true, wenn die angegebenen Zeichen am Anfang des Strings gefunden werden, auch 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ß-/kleinschreibungssensitiv.

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® 2025 Language Specification
# sec-string.prototype.startswith

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
startsWith

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch