string-split-by-whitespace

Split string into array by chunks of whitespace

Install

This package is pure ESM. If you're not ready yet, install an older version of this program, 2.1.0 (npm i string-split-by-whitespace@2.1.0).

1npm i string-split-by-whitespace

Quick Take

1import { strict as assert } from "assert";
2
3import { splitByW } from "string-split-by-whitespace";
4
5// Split by whitespace is easy - use native String.prototype.split()
6assert.deepEqual("abc  def ghi".split(/\s+/), ["abc", "def", "ghi"]);
7
8const source = "\n     \n    a\t \nb    \n      \t";
9
10// this program is nearly equivalent to regex-based split:
11assert.deepEqual(source.split(/\s+/), ["", "a", "b", ""]);
12assert.deepEqual(splitByW(source), ["a", "b"]);
13// regex-based split needs more filtration but it's native solution
14
15// ADDITIONALLY...
16
17// this program allows to exclude certain index ranges:
18assert.deepEqual(
19  splitByW("a b c d e", {
20    ignoreRanges: [[0, 2]], // that's "a" and space after it
21  }),
22  ["b", "c", "d", "e"],
23);

Documentation

Please visit codsen.com for a full description of the API.

Contributing

To report bugs or request features or assistance, raise an issue on GitHub.

Licence

MIT License.

Copyright © 2010-2025 Roy Revelt and other contributors.