Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.prototype.split — dividir texto num array

String.prototype.split divide o texto com base num separador e devolve um array de partes. Saiba como funcionam o limite e os elementos vazios, e qual é a diferença entre um separador vazio e um separador omitido.

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

Sintaxe

string.split(separator, limit)

String.prototype.split divide o texto da esquerda para a direita sem alterar o original. Um separador do tipo cadeia de caracteres é comparado literalmente e não é incluído no array resultante. Separadores consecutivos e separadores no início ou no fim podem produzir elementos vazios.

Se separator for omitido ou tiver o valor undefined, o método devolve um array com a cadeia inteira, exceto se o limite for zero. Se não houver correspondência, a cadeia inteira também permanece intacta. O separador "" divide em unidades de código UTF-16, que nem sempre correspondem a caracteres completos tal como são percecionados pelo utilizador; "".split("") devolve [].

O argumento opcional limit limita o número de elementos, não o número de divisões: o texto restante é descartado. O valor predefinido é 2 ** 32 - 1; o valor fornecido é convertido através de ToUint32. Um limit de 0 produz [].

O separador também pode ser um objeto com um método [Symbol.split], como um RegExp. Nesse caso, split passa o recetor e o limite a esse método e devolve diretamente o resultado; um método personalizado pode alterar as regras descritas acima. Chamar String.prototype.split com null ou undefined como recetor lança um TypeError.

Exemplos

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("")));

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes