Neurotic Pantaloon Maker
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



    get/set api for .json files, like config files

    usage example

    var dotjson = require('dotjson')
    // get the version from package.json
    var version = dotjson.get('./node_modules/package.json', 'version')
    // set some configuration options, creating the file if it doesn't exist
      powerLevel: 9001
    , robotMorale: 'high and steady'
    , isRaining: false
    {createFile: true})


    dotjson.get(filename, path)

    Reads the contents of filename and returns the value of path. path can be a single path or an array of paths. if it's a single path, get returns it. if it's an array of paths, get returns an array of values in the same order, like If the path is not found, the value will be undefined.

    Throws an error if there is a problem reading from the file.

    dotjson.set(filename, setter, opts)

    Opens filename and upserts it according to setter, an object map of paths and values. For example, if the config file currently contains {name: {first: 'alice', last: 'cooper'}}, then the following setter would update the config to refer to a certain reporter:

      'name.first': 'anderson'

    Since setter is an object, you can specify multiple path/value pairs to set in one operation.

    opts is an (optional) options object.


    • createFile (boolean, default false) - attempt to create the file if it does not already exist

    Throws an error if there is a problem writing to the file.

    Returns void.

    path notation

    This module uses mongodb dot notation for paths. It's simple, really - imagine you're writing javascript using only [] bracket accessor notation. Now do that, but with dots instead, including for array indices. See also @rauchg's module, dot-component.


    run npm test from the root module directory

    zomg, BLOCKING, wtf? o_O

    Yes, it's meant for working with tiny json config files in cli scripts. If things like performance, memory usage, or concurrency are important, this might not be your module. If you just want to work with json config files with ease, read on.


    MIT (c) 2012 jden - Jason Denizac


    npm i dotjson

    Downloadsweekly downloads







    last publish