JS: String.prototype.split
str.split(string_separator)
Split the string by separator string_separator.
Return a array. The separator is not included in result.
str.split(regex)
Split the string by separator regex.
If regex contains capturing parentheses, the captured parts are included in result.
str.split(sep, n)
Return a array of n items at most.
str.split()
Return array [str]
.
str.split("")
Return a array, each element is a character. (Note: technically, each element is a code unit.)
[see JS: Character, Code Unit, Code Point]
String Separator Example
The separator eats the string.
"abcde".split("c") // [ 'ab', 'de' ]
Repeated space in string may result empty string element in array.
console.log ( ' a b c '.split (' ') ); // [ '', 'a', '', 'b', 'c', '' ]
Use filter
to remove empty string in array.
[see JS: Array.prototype.filter]
Regex Separator Example
Using regex as separator.
const t3 = 'a b c'; console.log ( t3.split (/ +/) ); // [ 'a', 'b', 'c' ]
Using regex with capture.
const t4 = 'a b c'; console.log ( t4.split (/( +)/) ); // [ 'a', ' ', 'b', ' ', 'c' ]
[see JS: RegExp Syntax]
Max Length Example
Limit max length.
const tt = `a b c`; console.log ( tt.split ('\n',2) ); // [ 'a', 'b' ]
Other Example
Split by a character that doesn't exist, return full string
// split by a char that doesn't exist, returns full string console.log ( "abc".split("-") ); // [ 'abc' ]
Reference
ECMAScript 2015 §Text Processing#sec-string.prototype.split
JS String
RegExp Topic
JS Array
If you have a question, put $5 at patreon and message me.