Die startsWith()-Methode stellt fest, ob ein String mit den Zeichen eines anderen Strings beginnt, falls dies so ist wird true, sonst wird false
zurückgegeben.
str.startsWith(searchString[, position])
Parameter
searchString
- Die Zeichen, die am Anfang eines Strings gesucht werden.
position
- Optional. Die Position, an der die Suche nach
searchString
begonnen werden soll. Der Standardwert ist 0.
Rückgabewert
true wenn der String mit den Zeichen aus dem übergebenen String beginnt, andernfalls false.
Beschreibung
Diese Methode dient dazu herauszufinden, ob ein String am Anfang eines anderen Strings steht. Die Methode unterscheidet Groß- und Kleinschreibung.
Beispiele
Benutzung von startsWith()
//startswith var str = 'Sein oder nicht sein, dass ist hier die Frage'; console.log(str.startsWith('Sein oder')); // true console.log(str.startsWith('nicht sein')); // false console.log(str.startsWith('nicht sein', 10)); // true
Polyfill
Diese Methode ist bestandteil der ECMAScript 6 Spezifikation, es kann allerdings sein, dass sie trotzdem noch nicht in JavaScriptimplementierungen vorhanden ist. Trotzdem kann man in diesem Fall die Methode wie folgt "selbst implementieren":
if (!String.prototype.startsWith) { String.prototype.startsWith = function(searchString, position) { position = position || 0; return this.indexOf(searchString, position) === position; }; }
Eine robustere und schnellerer (optimierte) Version findet sich auf GitHub, geschrieben von Mathias Bynens.
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'String.prototype.startsWith' in dieser Spezifikation. |
Standard | Initiale Definition. |
ECMAScript 2017 Draft (ECMA-262) Die Definition von 'String.prototype.startsWith' in dieser Spezifikation. |
Entwurf |
Browserkompatibilität
Feature | Chrome | Firefox (Gecko) | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 41 | 17 (17) | (Ja) | Nicht unterstützt | 28 | 9 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | Nicht unterstützt | 36 | 17.0 (17) | Nicht unterstützt | Nicht unterstützt | Nicht unterstützt |
Zu beachten ist, dass die MSDN Dokumentation für diese Methode (https://msdn.microsoft.com/en-us/library/mt146831(v=vs.94).aspx) besagt, das es nicht im Internet Explorer unterstützt wird.