Pretty-print a javascript object as a tree
Latest commit cc52f68 Jul 29, 2016 @notatestuser Create LICENSE
Failed to load latest commit information.
examples examples: added a browser version of the eukaryotes example to demons… Mar 30, 2013
test fixed an issue exposed by my line-by-line test of the function omissi… Dec 24, 2012
.gitignore Initial commit Sep 30, 2012
.travis.yml Removed node 0.4 from CI test targets Feb 10, 2014
LICENSE Create LICENSE Jul 29, 2016 readme: moved badges around May 12, 2016
package.json package.json: added license Jul 29, 2016


Build Status

treeify converts a JS object into a nice, visible depth-indented tree for console printing. The structure generated is similar to what you get by running the tree command on Unixy platforms.

    oranges: {
        'mandarin': {                                          ├─ oranges
            clementine: null,                                  │  └─ mandarin
            tangerine: 'so cheap and juicy!'        -=>        │     ├─ clementine
        }                                                      │     └─ tangerine: so cheap and juicy!
    },                                                         └─ apples
    apples: {                                                     ├─ gala
        'gala': null,                                             └─ pink lady
        'pink lady': null

It also works well with larger nested hierarchies such as file system directory trees. In fact, the fs_tree example does a pretty good job of imitating tree. Try it out!

See the other included examples or the test suite for usage scenarios.

Getting it

For use with node.js

First you'll want to run this command in your project's root folder:

$ npm install treeify

Then proceed to use it in your project:

var treeify = require('treeify');
      apples: 'gala',      //  ├─ apples: gala
      oranges: 'mandarin'  //  └─ oranges: mandarin
   }, true)

For use in a browser

Treeify cooperates with Node, AMD or browser globals to create a module. This means it'll work in a browser regardless of whether you have an AMD-compliant module loader or not. If such a loader isn't found when the script is executed, you may access Treeify at window.treeify.


The methods exposed to you are as follows, in a strange kind of signature notation:


treeify.asLines(obj, showValues (boolean), [hideFunctions (boolean),] lineCallback (function))
// NOTE: hideFunctions is optional and may be safely omitted - this was done to ensure we don't break uses of the previous form


treeify.asTree(obj, showValues (boolean), hideFunctions (boolean)): String

Running the tests

There's a pretty extensive suite of Vows tests included.

$ npm test