jsdoc-extractor

JSDoc comments/annotations extractor

MIT License

Downloads
16.3K
Stars
2
Committers
4

Requirements

  • Node.js v18 or higher

Getting Started

This package is available in the Node Package Repository and can be easily installed with npm or yarn.

$ npm i jsdoc-extractor
# or
$ yarn add jsdoc-extractor

Usage example

const jsdocExtractor = require("jsdoc-extractor");
const { readFileSync } = require("fs");

const buf = readFileSync("./sourceCode.js");
for (const [doc, start, end] of jsdocExtractor(buf)) {
    console.log(`Found a new JSDoc block between ${start} and ${end}`);
    console.log(doc.toString());
    console.log("-------------");
}

API

jsdocExtractor(buf: Buffer): IterableIterator< [Buffer, number, number] >

Take a buffer as Argument and return a Synchronous Iterator. The value returned by the iterator is the following:

[buffer, start, end]

Where start and end are the offset to retrieve (slice) the original Buffer.

Related projects

name description
jsdoc-tokenizer Tokenizer for JSDoc blocks

Contributors ✨

Thanks goes to these wonderful people (emoji key):

License

MIT