JavaScript/Objekte/String/startsWith

Aus SELFHTML-Wiki
Wechseln zu: Navigation, Suche

Die Methode startsWith() von String.prototype ermittelt, ob eine Zeichenkette mit den Zeichen einer angegebenen Zeichenkette beginnt, und gibt je nach Ergebnis true oder false zurück.

Syntax

str.startsWith(searchString)

str.startsWith(searchString, position)

  • searchString: Die Zeichenkette, mit verglichen werden soll.
    • Die Übergabe eines RegExp-Objekts[1] oder eines Symbols ist unzulässig und wirft einen TypeError.
    • Alle anderen Werte werden in eine Zeichenkette konvertiert. Die Übergabe von null oder undefined führt allerdings zu den Zeichenketten "null" bzw. "undefined", was zumeist nicht erwünscht ist.
  • position (Optional) Die Position, an der in str mit dem Vergleich begonnen werden soll. Der Standardwert ist 0.

Rückgabewert

  • true, wenn eine Übereinstimmung festgestellt wurde, andernfalls false.
    Beachten: Wenn searchString ein Leerstring ist, liefert startsWith() immer true.


Beispiel
const str1 = 'Saturday night plans';

console.log(str1.startsWith('Sat'));
// Expected output: true

console.log(str1.startsWith('Sat', 3));
// Expected output: false


Weblinks

  • ECMA 262: Spezifikation von String.prototype.startsWith(searchString [, position)]