durable-json-lint

A Json Lint library that can parse and partially correct dirty Json.

Usage no npm install needed!

<script type="module">
  import durableJsonLint from 'https://cdn.skypack.dev/durable-json-lint';
</script>

README

Durable Json Lint


Durable Json Lint is a Json Lint library that can parse and partially correct dirty Json. Unlike most Json lint libraries it does its best not to crash after encountering errors. It can be installed via npm using the command npm install durable-json-lint.

Features


  • Can correct simple errors like using ' instead of "
  • Most of the time it will report more than the first error encountered in the Json
  • If dirty Json is encountered (for example a function call) the error will be reported and a null will be substituted in for the invalid Json, creating valid Json.

Usage


durableJsonLint = require('durable-json-lint');
console.log(durableJsonLint('{name:"value", \'array\':[call(), 0x11]}'))
// The above code would print the following to the console
{
   "json":'{"name":"value", "array":[null, 17]}',
   "errors":[{
         "column":1,
         "description":"Keys must be double quoted in Json. Did you mean \"name\"?",
         "lineNumber":1,
         "status":"correctable"
      },{
         "column":15,
         "description":"Json strings must use double quotes",
         "lineNumber":1,
         "status":"correctable"
      },{
         "column":24,
         "description":"You can not make function calls in Json. Do you think I am a fool?",
         "lineNumber":1,
         "status":"fail"
      },{
         "column":32,
         "description":"Invalid Json number",
         "lineNumber":1,
         "status":"correctable"
      }
   ]
}

Durable Json Lint runs in the browser too! You can checkout the example above at JS Bin.

Api


A single function is exposed with the following signature

durableJsonLint(sourceCode);

The function returns an object with the following format

{
    json:'{"json":"string"}' //the corrected Json
    errors:[                 //a list of errors
        {
            lineNumber:9     //the line the error occurred on
            column:9         //the column the error occurred on
            description:"txt"//a description of the error
            status:"fail"    //the status of the error
        }
    ]
}

Error Status

It is worth briefly describing the possible error statuses

  • correctable: the error can be automatically corrected
  • guessable: the parser has a good guess about how the error can be automatically corrected
  • fail: the parser has no idea how to fix the error. The parser will likely just substitute in null
  • crash: the parser was completely unable to parse the Json.