Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje