bracket-split

Bracket-aware split function, can be used to split a string containing JSON objects

Usage no npm install needed!

<script type="module">
  import bracketSplit from 'https://cdn.skypack.dev/bracket-split';
</script>

README

bracket-split

This module can do bracket-aware splitting of strings!

Example:

const bracketSplit = require('bracket-split');

bracketSplit(
    ' ',
    '{ "status": "ok" } [ "status" ] 2 3')
//-> [ '{ "status": "ok" }', '[ "status" ]', '2', '3' ]

Options

bracketSplit(
    delimiter,
    str,
    brackets = [ [ '{', '}' ], [ '[', ']' ] ],
    quotes = [ '\'', '"' ],
    escaper = '\\'
)

delimiter and str work as if you did str.split(delimiter)

brackets are pairs of brackets to treat specially, these will be checked for maching pairs in the str you are splitting, and errors may be thrown!

quotes are quote characters, brackets will be ignored if they are quoted (treated as plain strings)

escaper is a string to prefix another character in order to always treat it as a normal character (you can escape quotes and brackets to ignore them)

heredocs are pairs of brackets to treat as special overriding unnestable brackets, they support escaping and work a bit differently from normal brackets

Possible errors

Unexpected closing bracket: <closing bracket>
Unexpected end of input, expected: <quote or closing bracket>