Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje