CKTIS / JavaScript
String.prototype.startsWith — kontrola predpony reťazca
Metóda startsWith kontroluje, či má reťazec zadanú predponu na začiatku alebo presne na určenej pozícii. Vráti logickú hodnotu, rozlišuje veľké a malé písmená a reťazec nemení.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.startsWith(searchString[, position])String.prototype.startsWith vráti true, keď searchString presne zodpovedá od indexu position; inak vráti false. Nehľadá zhodu na neskorších pozíciách a reťazec nemení.
Predvolená hodnota position je 0. Hodnota sa prevedie na celé číslo odrezaním zlomkovej časti smerom k nule a potom sa obmedzí na rozsah od 0 po dĺžku reťazca; NaN znamená 0. Indexy počítajú jednotky kódu UTF-16, ktoré nemusia zodpovedať celým znakom vnímaným používateľom.
Pri porovnávaní sa rozlišujú veľké a malé písmená a Unicode sa nenormalizuje. Prázdny searchString vráti true, aj keď zadaná pozícia presahuje dĺžku reťazca. Ostatné hodnoty sa prevedú na reťazce: ak sa argument vynechá, hľadá sa "undefined". Bežný regulárny výraz spôsobí TypeError.
Metóda môže pomocou call fungovať aj s inými prijímateľmi, ktoré prevedie na reťazce, ale prijímateľ null alebo undefined spôsobí TypeError. Ide o jazykové API ECMAScriptu, nie o API DOM; samotná špecifikácia nepotvrdzuje podporu v konkrétnom prehliadači.
Prí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ýsledok
true false true false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.