CKTIS / JavaScript
String.prototype.startsWith — kontrola předpony řetězce
Metoda startsWith kontroluje, zda má řetězec zadanou předponu na začátku nebo přesně na určené pozici. Vrací logickou hodnotu, rozlišuje velká a malá písmena a řetězec nemění.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
string.startsWith(searchString[, position])String.prototype.startsWith vrací true, pokud searchString přesně odpovídá od indexu position; jinak vrací false. Nehledá shodu na pozdějších pozicích a řetězec nemění.
Výchozí hodnota position je 0. Hodnota se převede na celé číslo oříznutím desetinné části směrem k nule a poté se omezí na rozsah od 0 do délky řetězce; NaN znamená 0. Indexy počítají jednotky kódu UTF-16, které nemusí odpovídat celým znakům vnímaným uživatelem.
Při porovnávání se rozlišují velká a malá písmena a Unicode se nenormalizuje. Prázdný searchString vrací true, i když zadaná pozice přesahuje délku řetězce. Ostatní hodnoty se převádějí na řetězce: při vynechání argumentu se hledá "undefined". Běžný regulární výraz způsobí TypeError.
Metoda může pomocí call fungovat i s jinými příjemci, které převede na řetězce, ale příjemce null nebo undefined způsobí TypeError. Jde o jazykové API ECMAScriptu, nikoli o API DOM; samotná specifikace nepotvrzuje podporu v konkrétním prohlížeči.
Příklady
const text = "Hello, world!";
console.log(text.startsWith("Hello"));
console.log(text.startsWith("hello"));
console.log(text.startsWith("world", 7));
console.log(text.startsWith("world", 6));
console.log(text.startsWith("", 99));Výsledek
true false true false true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.