Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.includes — verificare la presenza di una sottostringa

String.prototype.includes verifica se un testo contiene una determinata sottostringa e restituisce true o false. Distingue tra maiuscole e minuscole, permette di specificare una posizione iniziale e non accetta le normali espressioni regolari.

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

Sintassi

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

String.prototype.includes cerca una sottostringa letterale e restituisce true o false senza modificare il testo. Distingue tra maiuscole e minuscole e confronta unità di codice UTF-16: non normalizza Unicode né applica regole di confronto specifiche delle lingue.

Il parametro facoltativo position indica l'indice iniziale più precoce per una corrispondenza, contando da zero in unità di codice UTF-16. Il valore predefinito è 0; dopo la conversione in numero, la parte frazionaria viene troncata verso zero e il risultato viene limitato all'intervallo da 0 alla lunghezza del testo. Se il metodo arriva alla fase di ricerca, restituisce true per un searchString vuoto, anche se la posizione fornita supera la lunghezza del testo. Tuttavia, position viene convertito prima della ricerca: passare un BigInt come position genera un TypeError anche se searchString è vuoto.

Un normale oggetto RegExp usato come searchString causa un TypeError; formalmente, a determinarlo è il test IsRegExp, che tiene conto di Symbol.match. Gli altri argomenti di ricerca vengono convertiti in testo, quindi, se l'argomento è omesso, viene cercato "undefined". Chiamare il metodo con null o undefined come this causa un TypeError.

È un metodo della libreria standard ECMAScript, non una Web API. Il supporto in uno specifico browser va verificato separatamente; la disponibilità in Node 24 non dimostra il supporto nei browser.

Esempi

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);
}

Risultato

true
false
false
true
TypeError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti