Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.endsWith — verificare la fine di una stringa

String.prototype.endsWith controlla se una stringa termina con il testo specificato e restituisce true o false. Distingue tra maiuscole e minuscole, non modifica la stringa e permette di indicare un limite finale precedente per il controllo.

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.endsWith(searchString[, endPosition])

String.prototype.endsWith confronta searchString con la parte finale di una stringa e restituisce true o false senza modificare l’originale. Il confronto distingue tra maiuscole e minuscole e opera su unità di codice UTF-16, senza normalizzazione Unicode. È un metodo della libreria standard ECMAScript, non un’API del browser.

Il parametro facoltativo endPosition imposta un limite finale esclusivo: il metodo controlla la fine del prefisso che arriva fino a quel limite, non una sottostringa che inizia lì. Se l’argomento viene omesso o vale undefined, viene usata la lunghezza completa. Dopo la conversione in un intero, il valore viene limitato all’intervallo da 0 alla lunghezza della stringa; i valori negativi non contano a ritroso dalla fine. Le posizioni sono misurate in unità di codice UTF-16.

Se searchString è vuoto, il metodo restituisce true anche al limite 0, purché l’eventuale conversione di endPosition vada a buon fine. La conversione avviene prima del confronto: passare 0n come valore di endPosition causa un TypeError anche se searchString è vuoto. L’argomento searchString viene convertito in una stringa, quindi se viene omesso si usa il testo "undefined". Un argomento riconosciuto come espressione regolare causa un TypeError. Anche chiamare il metodo con null o undefined come valore di this causa un TypeError.

Nell’esempio, il limite 10 si trova subito dopo report.txt, quindi il controllo di .txt restituisce true, anche se l’intera stringa termina con .bak. Il controllo di .BAK restituisce false perché le maiuscole e le minuscole non corrispondono.

Esempi

const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));

Risultato

true
true
false
true

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