JS: String.prototype.split

By Xah Lee. Date: . Last updated: .

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: String Code Unit vs 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

String Topic

  1. JS: String Overview
  2. JS: Template String
  3. JS: String Object
  4. JS: String.prototype
  5. JS: String Code Unit vs Code Point
  6. JS: String Escape Sequence
  7. JS: Unicode Escape Sequence
  8. JS: Source Code Encoding
  9. JS: Allowed Characters in Identifier
  10. JS: Convert String to Number
  11. JS: Encode URL, Escape String
  12. JS: Format Number
  13. JS: JSON

RegExp Topic

  1. JS: RegExp Tutorial
  2. JS: RegExp Syntax
  3. JS: Regex Find/Replace
  4. JS: RegExp Object
  5. JS: RegExp Constructor
  6. JS: RegExp.prototype

Array Topic

  1. JS: Array Basics
  2. JS: Understand JS Array
  3. JS: Create Array
  4. JS: Sparse Array
  5. JS: Array-Like Object
  6. JS: Array How-To
  7. JS: Array Object
  8. JS: Array.prototype
Liket it? Put $5 at patreon.

Or, Buy JavaScript in Depth

If you have a question, put $5 at patreon and message me.