CKTIS / JavaScript
String.prototype.startsWith — verificare il prefisso di una stringa
Il metodo startsWith verifica se una stringa ha un determinato prefisso all’inizio o esattamente in una posizione specificata. Restituisce un valore booleano, distingue tra maiuscole e minuscole e non modifica la stringa.
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
string.startsWith(searchString[, position])String.prototype.startsWith restituisce true quando searchString corrisponde esattamente all’indice position; altrimenti restituisce false. Non cerca corrispondenze nelle posizioni successive e non modifica la stringa.
Il valore predefinito di position è 0. Il valore viene convertito in un intero troncando la parte frazionaria verso zero e poi limitato all’intervallo da 0 alla lunghezza della stringa; NaN equivale a 0. Gli indici contano unità di codice UTF-16, che non corrispondono necessariamente a caratteri completi percepiti dall’utente.
Il confronto distingue tra maiuscole e minuscole e non normalizza Unicode. Un searchString vuoto restituisce true, anche quando la posizione indicata supera la lunghezza della stringa. Gli altri valori vengono convertiti in stringhe: se l’argomento viene omesso, la ricerca riguarda "undefined". Un’espressione regolare ordinaria causa un TypeError.
Il metodo può funzionare anche con altri ricevitori tramite call, convertendoli in stringhe, ma un ricevitore null o undefined causa un TypeError. Questa è un’API del linguaggio ECMAScript, non un’API DOM; la sola specifica non dimostra il supporto in uno specifico browser.
Esempi
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));Risultato
true false 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.