Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 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 str = "Saturday night plans";

console.log(str.startsWith("Sat"));
// Expected output: true

console.log(str.startsWith("Sat", 3));
// Expected output: false

Syntax

js
startsWith(searchString)
startsWith(searchString, position)

Parameter

searchString

Die Zeichen, die am Anfang dieses Strings gesucht werden sollen. Kann kein Regex sein. Alle Werte, die keine Regex sind, werden zu Strings konvertiert, 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). Standardmäßig 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 case-sensitive.

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

Spezifikation
ECMAScript® 2026 Language Specification
# sec-string.prototype.startswith

Browser-Kompatibilität

Siehe auch