Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.split — dividir texto en un array

String.prototype.split divide el texto mediante un separador y devuelve un array de partes. Aprende cómo funcionan el límite y los elementos vacíos, y en qué se diferencia un separador vacío de uno omitido.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

string.split(separator, limit)

String.prototype.split divide el texto de izquierda a derecha sin modificar el original. Si el separador es una cadena, se busca literalmente y no se incluye en el array resultante. Los separadores adyacentes y los que aparecen al principio o al final pueden producir elementos vacíos.

Si se omite separator o su valor es undefined, se devuelve un array que contiene toda la cadena, salvo que el límite sea cero. Si no hay coincidencias, también se conserva la cadena completa. El separador "" divide en unidades de código UTF-16, que no siempre son caracteres completos tal como los perciben los usuarios; "".split("") devuelve [].

El argumento opcional limit limita el número de elementos, no el número de divisiones: el texto restante se descarta. Su valor predeterminado es 2 ** 32 - 1; el valor indicado se convierte mediante ToUint32. Un limit de 0 produce [].

El separador también puede ser un objeto con un método [Symbol.split], como un RegExp. En ese caso, split pasa a ese método el receptor y el límite, y devuelve directamente su resultado; un método personalizado puede cambiar las reglas descritas anteriormente. Llamar a String.prototype.split con null o undefined como receptor provoca un TypeError.

Ejemplos

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,"]
[]

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes