los split() el método divide un String en una lista ordenada de subcadenas, coloca estas subcadenas en una arrayy devuelve el array. La división se realiza buscando un patrón; donde el patrón se proporciona como primer parámetro en la llamada al método.

Sintaxis

split()split(separator)split(separator, limit)

Parámetros

separatorOpcional

El patrón que describe dónde debe ocurrir cada división. los separator puede ser un simple string o puede ser una expresión regular.

  • El caso más simple es cuando separator es solo un carácter; esto se usa para dividir un delimitado string. Por ejemplo, un string que contienen valores separados por tabulaciones (TSV) se pueden analizar pasando un carácter de tabulación como separador, como este: myString.split("t").
  • Si separator contiene varios caracteres, esa secuencia completa de caracteres debe encontrarse para poder dividir.
  • Si separator se omite o no aparece en str, El retorno array contiene un elemento que consta de la totalidad string.
  • Si separator aparece al principio (o al final) de la string, todavía tiene el efecto de dividirse. El resultado es un vacío (es decir, longitud cero) string, que aparece en la primera (o última) posición de la devolución array.
  • Si separator es un vacio string (""), str se convierte en un array de cada uno de sus “caracteres” UTF-16.

Advertencia: Cuando el vacio string ("") se utiliza como separador, el string es no dividido por personajes percibidos por el usuario (grupos de grafemas) o caracteres Unicode (puntos de código), pero por unidades de código UTF-16. Esto destruye pares sustitutos. Ver “¿Cómo se obtiene un string a un personaje array en JavaScript? ” en StackOverflow.

limitOpcional

Un entero no negativo que especifica un límite en el número de subcadenas que se incluirán en el array. Si se proporciona, divide el string en cada ocurrencia de la especificada separator, pero se detiene cuando limit Las entradas se han colocado en el array. Cualquier texto sobrante no se incluye en el array en absoluto.

  • los array puede contener menos entradas que limit si el final de la string se alcanza antes de que se alcance el límite.
  • Si limit es 0, [] es regresado.

Valor devuelto

Un Array de cuerdas, dividido en cada punto donde el separator ocurre en el dado string.

Descripción

Cuando se encuentra, separator se elimina de la string, y las subcadenas se devuelven en un array.

Si separator es una expresión regular con paréntesis de captura, luego cada vez separator coincidencias, los resultados (incluidos los undefined resultados) de los paréntesis de captura se empalman en la salida array.

Si el separador es un array, entonces esa matriz se convierte en una cadena y se usa como separador.

Ejemplos de

Utilizando split()

Cuando el string esta vacio, split() devuelve un array conteniendo uno vacío string, en lugar de un vacío array. Si el string y el separador son cadenas vacías, un vacío array es regresado.

const myString =''const splits = myString.split()

console.log(splits)// ↪ [""]

El siguiente ejemplo define una función que divide un string en una array de cadenas usando separator. Después de dividir el string, la función registra mensajes que indican el original string (antes de la división), el separador utilizado, el número de elementos en el array, y el individuo array elementos.

functionsplitString(stringToSplit, separator)const arrayOfStrings = stringToSplit.split(separator)

  console.log('The original string is: ', stringToSplit)
  console.log('The separator is: ', separator)
  console.log('The array has ', arrayOfStrings.length,' elements: ', arrayOfStrings.join(' / '))const tempestString ='Oh brave new world that has such people in it.'const monthString ='Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec'const space =' 'const comma =','splitString(tempestString, space)splitString(tempestString)splitString(monthString, comma)

Este ejemplo produce la siguiente salida:

The original string is: "Oh brave new world that has such people in it."
The separator is: " "
The array has 10 elements: Oh / brave / new / world / that / has / such / people / in / it.

The original string is: "Oh brave new world that has such people in it."
The separator is: "undefined"
The array has 1 elements: Oh brave new world that has such people in it.

The original string is: "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
The separator is: ","
The array has 12 elements: Jan / Feb / Mar / Apr / May / Jun / Jul / Aug / Sep / Oct / Nov / Dec

Eliminar espacios de un string

En el siguiente ejemplo, split() busca cero o más espacios, seguido de un punto y coma, seguido de cero o más espacios y, cuando lo encuentra, elimina los espacios y el punto y coma de la string. nameList es el array devuelto como resultado de split().

const names ='Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand '

console.log(names)const re =/s*(?:;|$)s*/const nameList = names.split(re)

console.log(nameList)

Esto registra dos líneas; la primera línea registra el original string, y la segunda línea registra el resultado array.

Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand
[ "Harry Trump", "Fred Barney", "Helen Rigby", "Bill Abel", "Chris Hand", "" ]

Devolver un número limitado de divisiones

En el siguiente ejemplo, split() busca espacios en un string y devuelve las 3 primeras divisiones que encuentra.

const myString ='Hello World. How are you doing?'const splits = myString.split(' ',3)

console.log(splits)

Este script muestra lo siguiente:

["Hello","World.","How"]

Dividiendo con un RegExp para incluir partes del separador en el resultado

Si separator es una expresión regular que contiene la captura de paréntesis (), los resultados coincidentes se incluyen en el array.

const myString ='Hello 1 word. Sentence number 2.'const splits = myString.split(/(d)/)

console.log(splits)

Este script muestra lo siguiente:

["Hello ","1"," word. Sentence number ","2","."]

Nota:d coincide con el clase de personaje para dígitos entre 0 y 9.

Invertir una cuerda usando split()

Advertencia: Ésta no es una forma sólida de revertir una string:

const str ='asdfghjkl'const strReverse = str.split('').reverse().join('')// 'lkjhgfdsa'// split() returns an array on which reverse() and join() can be applied

No funciona si el string contiene grupos de grafemas, incluso cuando se utiliza una división compatible con Unicode. (Utilice, por ejemplo, esrever en lugar de.)

const str ='résumé'const strReverse = str.split(/(?:)/u).reverse().join('')// => "́emuśer"

Prima: usar === operador para probar si el original string era un palíndromo.

Especificaciones

Especificación
Especificación del lenguaje ECMAScript (ECMAScript)
#segundo-string.prototype.split

Compatibilidad del navegador

Escritorio Móvil
Cromo Borde Firefox explorador de Internet Ópera Safari WebView Android Chrome Android Firefox para Android Opera Android Safari en IOS Internet de Samsung
split 1 12 1 4 3 1 1 18 4 10.1 1 1.0

Ver también