Installation

Usage

API Documentation

Check if a JSON string is valid:

constsimdjson=require('simdjson');constjsonString="{ \"answer\": 42 }";constvalid=simdjson.isValid(jsonString);// true

Parsing a JSON string (lazily)

constsimdjson=require('simdjson');constjsonString="{   \  \"foo\": {            \    \"bar\": [ 0, 42 ]  \  }                     \}";constJSONbuffer=simdjson.lazyParse(jsonString);// external (C++) parsed JSON objectconsole.log(JSONbuffer.valueForKeyPath("foo.bar[1]"));// 42

Parsing a JSON string

constsimdjson=require('simdjson');constjsonString="{   \  \"foo\": {            \    \"bar\": [ 0, 42 ]  \  }                     \}";constparsedJSON=simdjson.parse(jsonString);// parsed JSON object

Benchmarks

git clone https://github.com/luizperes/simdjson_nodejs.gitcd simdjson_nodejsnpm installnpm run benchmark

Ops/sec

apache_builds.json#simdjson x 6,844 ops/sec ±1.61% (90 runs sampled) => 0.146msapache_builds.json#JSON x 3,274 ops/sec ±1.83% (90 runs sampled) => 0.305mscanada.json#simdjson x 183 ops/sec ±7.69% (72 runs sampled) => 5.475mscanada.json#JSON x 71.87 ops/sec ±0.92% (74 runs sampled) => 13.914mscitm_catalog.json#simdjson x 155 ops/sec ±2.95% (72 runs sampled) => 6.470mscitm_catalog.json#JSON x 207 ops/sec ±59.63% (90 runs sampled) => 4.820msgithub_events.json#simdjson x 11,783 ops/sec ±1.80% (90 runs sampled) => 0.085msgithub_events.json#JSON x 120 ops/sec ±192.65% (92 runs sampled) => 8.310msgsoc_2018.json#simdjson x 307 ops/sec ±1.81% (79 runs sampled) => 3.255msgsoc_2018.json#JSON x 166 ops/sec ±47.75% (81 runs sampled) => 6.029msinstruments.json#simdjson x 3,691 ops/sec ±2.06% (87 runs sampled) => 0.271msinstruments.json#JSON x 2,155 ops/sec ±0.83% (93 runs sampled) => 0.464msmarine_ik.json#simdjson x 140 ops/sec ±3.08% (73 runs sampled) => 7.133msmarine_ik.json#JSON x 51.20 ops/sec ±60.81% (76 runs sampled) => 19.533msmesh_pretty.json#simdjson x 504 ops/sec ±1.93% (87 runs sampled) => 1.985msmesh_pretty.json#JSON x 251 ops/sec ±1.02% (85 runs sampled) => 3.987msmesh.json#simdjson x 733 ops/sec ±0.99% (92 runs sampled) => 1.363msmesh.json#JSON x 349 ops/sec ±0.64% (89 runs sampled) => 2.869msnumbers.json#simdjson x 4,099 ops/sec ±1.10% (94 runs sampled) => 0.244msnumbers.json#JSON x 1,372 ops/sec ±38.74% (95 runs sampled) => 0.729msrandom.json#simdjson x 504 ops/sec ±0.97% (91 runs sampled) => 1.983msrandom.json#JSON x 538 ops/sec ±0.93% (91 runs sampled) => 1.859mssf_citylots.json#simdjson x 1.76 ops/sec ±4.02% (9 runs sampled) => 569.580mssf_citylots.json#JSON x 0.53 ops/sec ±20.38% (6 runs sampled) => 1880.563mstwitter.json#simdjson x 478 ops/sec ±0.68% (89 runs sampled) => 2.093mstwitter.json#JSON x 612 ops/sec ±0.90% (91 runs sampled) => 1.633mstwitterescaped.json#simdjson x 1,203 ops/sec ±1.80% (88 runs sampled) => 0.831mstwitterescaped.json#JSON x 488 ops/sec ±2.33% (82 runs sampled) => 2.051msupdate_center.json#simdjson x 469 ops/sec ±3.43% (85 runs sampled) => 2.132msupdate_center.json#JSON x 293 ops/sec ±12.87% (57 runs sampled) => 3.410ms

Observation: