Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

String.prototype.includes — preverjanje, ali je podniz prisoten

String.prototype.includes preveri, ali besedilo vsebuje dani podniz, in vrne true ali false. Razlikuje med velikimi in malimi črkami, omogoča določitev začetnega položaja in ne sprejema običajnih regularnih izrazov.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

str.includes(searchString)
str.includes(searchString, position)

String.prototype.includes išče dobesedni podniz in vrne true ali false, ne da bi spremenila besedilo. Razlikuje med velikimi in malimi črkami ter primerja kodne enote UTF-16: Unicode ne normalizira in ne uporablja jezikovno specifičnih pravil primerjanja.

Izbirni parameter position določa najzgodnejši indeks začetka ujemanja, štet od nič v kodnih enotah UTF-16. Privzeta vrednost je 0; po pretvorbi v število se ulomljeni del odreže proti ničli, rezultat pa se omeji na razpon od 0 do dolžine besedila. Če metoda pride do koraka iskanja, za prazen searchString vrne true, tudi če podani položaj presega dolžino besedila. Vendar se position pretvori pred iskanjem: vrednost tipa BigInt kot position sproži TypeError tudi pri praznem searchString.

Običajen objekt RegExp, uporabljen kot searchString, povzroči TypeError; formalno o tem odloča preizkus IsRegExp, ki upošteva Symbol.match. Drugi iskalni argumenti se pretvorijo v besedilo, zato se ob izpuščenem argumentu išče "undefined". Klic metode z null ali undefined kot this povzroči TypeError.

To je metoda standardne knjižnice ECMAScript, ne pa spletni API. Podporo v posameznem brskalniku je treba preveriti posebej; razpoložljivost v Node 24 ne dokazuje podpore v brskalnikih.

Primeri

const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));

try {
  text.includes(/Script/);
} catch (error) {
  console.log(error.name);
}

Rezultat

true
false
false
true
TypeError

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri