js-object-literal-parse: A JavaScript repository from mbest

Javascript Object Literal Parser

Splits an object literal string into a set of top-level key-value pairs.

License: MIT (http://www.opensource.org/licenses/mit-license.php)

Exports a single function, parseObjectLiteral(str) that accepts an object literal string (with or without enclosing braces) and returns an array of key-value string pairs. The key are strings, but unquoted keys are accepted as long as they don't contain these special characters: ,:()[]{}'"/. The value is any valid Javascript expression; the parser will return it as a string (without evaluating it).

Notes: This parser is more lenient than a standard JavaScript parser, accepting unquoted keys with special characters and accepting keys without a value. It also silently ignores errors such as a missing key (the value will be skipped). If a value expression contains unquoted spaces, they may be stripped in the result.

Acknowledgments: This parser's functionality is based on the parser included in Knockout 2.x by Steven Sanderson. The examples below are also based on the specs in Knockout. This parser's implementation is inspired by json-sans-eval by Mike Samuel. Compared to the Knockout 2.x parser, this one is smaller and about three times as fast. A version of this parser is now included in Knockout as of version 3.0.

Examples

Simple object literals

parseObjectLiteral("a: 1, b: 2, \"quotedKey\": 3, 'aposQuotedKey': 4");

[ ["a","1"], ["b","2"], ["quotedKey","3"], ["aposQuotedKey","4"] ]

With enclosing braces

parseObjectLiteral("{a: 1}");

[ ["a","1"] ]

String values

parseObjectLiteral(
      "a: \"comma, colon: brace{ bracket[ apos' escapedQuot\\\" end\","
    + "b: 'escapedApos\\' brace} bracket] quot\"'");

[
    ["a","\"comma, colon: brace{ bracket[ apos' escapedQuot\\\" end\""],
    ["b","'escapedApos\\' brace} bracket] quot\"'"]
]

Values with objects, arrays, function literals, and regular expressions

parseObjectLiteral(
      "myObject:{someChild:{}, someChildArray:[1,2,3], \"quotedChildProp\":'string value'},\n"
    + "someFn:function(a,b,c){var regex=/}/g;var str='/})({';return{};},"
    + "myArray:[{}, function(){}, \"my'Str\", 'my\"Str']"
    );

[
    ["myObject","{someChild:{},someChildArray:[1,2,3],\"quotedChildProp\":'string value'}"],
    ["someFn","function(a,b,c){var regex=/}/g;var str='/})({';return{};}"],
    ["myArray","[{},function(){},\"my'Str\",'my\"Str']"]
]

Keys with special characters

parseObjectLiteral("a.b: 1, b+c: 2, c=d: 3, d_e: 4");

[ ["a.b","1"], ["b+c","2"], ["c=d","3"], ["d_e","4"] ]

Keys without values, values without keys, etc.

parseObjectLiteral("keyonly, 'key:quoted', key:, {nokey: 4}");

[ ["keyonly",undefined], ["key:quoted",undefined], ["key",undefined], [undefined,"{nokey:4}"] ]

mbest/js-object-literal-parse

Javascript Object Literal Parser

Splits an object literal string into a set of top-level key-value pairs.

Examples