Documentation generating tool for JavaScript that matches comments to AST nodes.
Last updated 5 months ago by daliwali .
GPL-3.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install doc-tree -g
SYNC missed versions from official npm registry.


Build Status npm Version License

doc-tree parses comments in JavaScript code and outputs the structure and context of the comments in any particular format, JSDoc is the default but any documentation parsing function can be supplied. It traverses the Abstract Syntax Tree (AST) to determine the context of a comment. Basically it's glue code between the AST parser Acorn, and the JSDoc parser Doctrine, though any user-supplied parsing function may be used.

Get it from npm:

$ npm install -g doc-tree


doc-tree operates over stdio. Running doc-tree on its own source code, and outputting the result to docs.json:

$ doc-tree < lib/index.js > docs.json

Or you could use it programmatically, as part of a Node-based build script:

import fs from 'fs'
import docTree from 'doc-tree'

// Parse a string or a buffer.
let doc = docTree.parse(fs.readFileSync('example.js'))

// An array of parsed comments matched with their contexts.
let output = doc.output()

The output method accepts 2 arguments, a function that accepts a comment and returns anything, and an options object to pass to the custom function or the built-in parser, Doctrine.


This code documentation:

 * This is a **Foo** class.
class Foo {
     * This is the constructor.
     * @param {Object} options
    constructor (options) { ... }

Gets outputted as:

[{ comment: { description: '<p>This is a <strong>Foo</strong> class.</p>', tags: [] },
   context: { location: { start: [Object], end: [Object] },
              name: 'Foo', type: 'class' }
 { comment: { description: '<p>This is the constructor.</p>', tags: [Object] },
   context: { location: { start: [Object], end: [Object] },
              type: 'constructor', target: 'Foo' }

Descriptions are rendered into HTML using CommonMark. Use { render: false } in the options for output to turn it off.

The default JSDoc parser will only consider block comments that start with /**.


This software is licensed under the GNU General Public License v3.

Current Tags

  • 0.12.3                                ...           latest (5 months ago)

2 Versions

  • 0.12.3                                ...           5 months ago
  • 0.12.2                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (6)
Dev Dependencies (3)
Dependents (0)

Copyright 2014 - 2016 © |