Método String split() do JavaScript

Definição e uso

split() O método divide a string em um array de substrings.

split() O método retorna um novo array, sem alterar a string original.

Se (" ") for usado como delimitador, a string é dividida entre palavras.

Veja também:

Método slice()

Método substr()

Método substring()

Exemplo

Exemplo 1

Divida palavras

let text = "How are you doing today?";
const myArray = text.split(" ");

Experimente pessoalmente

Exemplo 2

Divida palavras e retorne a segunda palavra:

let text = "How are you doing today?";
const myArray = text.split(" ");
let word = myArray[1];

Experimente pessoalmente

Exemplo 3

Divida caracteres, incluindo espaços em branco:

const myArray = text.split(" ");

Experimente pessoalmente

Exemplo 4

Usando o parâmetro limit:

const myArray = text.split(" ", 3);

Experimente pessoalmente

Exemplo 5

Divida a string em caracteres e retorne o segundo caractere:

const myArray = text.split(" ");

Experimente pessoalmente

Exemplo 6

Usando um caractere como delimitador:

const myArray = text.split("o");

Experimente pessoalmente

Exemplo 7

Se omitido o parâmetro separator, retorna um array contendo a string original:

const myArray = text.split();

Experimente pessoalmente

Sintaxe

string.split(',separador, limitar)

parâmetro

parâmetro descrição
separador

Opcional. Usado para a string ou expressão regular de separação.

Se omitido, retorna um array contendo a string original.
limitar

opcional. Um inteiro que limita a quantidade de divisões.

os itens que excedem o limite são excluídos.

retorno

tipo descrição
Array um array que contém os valores divididos.

detalhes técnicos

parâmetro separador

Este parâmetro é uma string ou expressão regular, dividindo a string a partir do local especificado por esse parâmetro string.

parâmetro limitar

este inteiro opcional especifica o comprimento máximo do array retornado. Se este parâmetro for configurado, os substrings retornados não serão maiores que o número especificado por esse parâmetro. Se não for configurado, toda a string será dividida, independentemente do seu comprimento.

retorno

retorna um array de strings. Este array é obtido dividindo a string em separador o texto da string será dividido no local especificado pelo string os substrings criados pela divisão em substrings não incluem separador própria.

mas, se separador Se a expressão regular contiver subexpressões, então o array retornado incluirá substrings que correspondem a essas subexpressões (mas não incluirá o texto correspondente à expressão regular completa).

descrição

split() o método cria e retorna um array de strings, cujos elementos são a string especificada string de limitar de. Esses substrings são obtidos através de uma busca de início a fim na string por substrings que coincidem com separador coincidindo com o texto, dividindo antes e após o texto coincidindo string obtido. Os substrings retornados não incluem o texto do delimitador (com exceção do caso mencionado no final deste parágrafo). Se o delimitador coincide com o início da string, o primeiro elemento do array retornado é uma string vazia, ou seja, o texto antes do delimitador. Da mesma forma, se o delimitador coincide com o final da string, o último elemento do array retornado também é uma string vazia (assumindo limitar não há conflito).

não for especificado separadorentão simplesmente não está certo string a operação de divisão é executada, e o array retornado terá apenas um elemento, sem dividir os elementos da string. Se separador é uma string vazia ou uma expressão regular que coincide com uma string vazia, então string cada caractere entre eles será dividido, e o comprimento do array retornado será igual ao comprimento da string (assumindo limitar não for menor ou igual a essa comprimento）（Observe que isso é um caso especial, pois não há strings vazias antes do primeiro caractere ou após o último caractere).

Foi mencionado anteriormente que os substrings retornados pelo método não incluem o texto do delimitador usado para dividir a string. Mas se separador Se a expressão regular contiver subexpressões, então o array retornado incluirá substrings que correspondem a essas subexpressões (mas não incluirá o texto correspondente à expressão regular completa).

Atenção:string.split() a operação executada é a mesma que Array.join() a operação inversa é executada.

suporte do navegador

split() é uma característica do ECMAScript1 (ES1).

Todos os navegadores suportam completamente ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
suporte suporte suporte suporte suporte suporte

páginas relacionadas

String do JavaScript

Métodos da String do JavaScript

Pesquisa de String do JavaScript