Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.prototype.split — dividere il testo in un array

String.prototype.split divide il testo in corrispondenza di un separatore e restituisce un array di parti. Scopri come funzionano il limite e gli elementi vuoti e qual è la differenza tra un separatore vuoto e uno omesso.

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.split(separator, limit)

String.prototype.split divide il testo da sinistra a destra senza modificare l’originale. Un separatore sotto forma di stringa viene cercato alla lettera e non viene incluso nell’array risultante. Separatori adiacenti e separatori all’inizio o alla fine possono produrre elementi vuoti.

Se separator viene omesso o vale undefined, il metodo restituisce un array contenente l’intera stringa, a meno che il limite non sia zero. Anche quando non trova corrispondenze, lascia intatta l’intera stringa. Il separatore "" divide in unità di codice UTF-16, che non sempre corrispondono a caratteri completi percepiti dall’utente; "".split("") restituisce [].

L’argomento facoltativo limit limita il numero di elementi, non il numero di divisioni: il testo rimanente viene scartato. Il valore predefinito è 2 ** 32 - 1; il valore fornito viene convertito tramite ToUint32. Un limit pari a 0 produce [].

Il separatore può anche essere un oggetto con un metodo [Symbol.split], ad esempio un RegExp. In tal caso, split passa a quel metodo il ricevente e il limite, quindi ne restituisce direttamente il risultato; un metodo personalizzato può modificare le regole descritte sopra. Chiamare String.prototype.split con null o undefined come ricevente genera un TypeError.

Esempi

const text = "red,,blue,";
console.log(JSON.stringify(text.split(",")));
console.log(JSON.stringify(text.split(",", 2)));
console.log(JSON.stringify(text.split()));
console.log(JSON.stringify("".split("")));

Risultato

["red","","blue",""]
["red",""]
["red,,blue,"]
[]

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