JSPM

get-comments

1.0.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 11127
  • Score
    100M100P100Q126967F
  • License MIT

Extract javascript comments on per character basis. Comment object compatible with `acorn-extract-comments` and Esprima format.

Package Exports

  • get-comments

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (get-comments) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

get-comments npmjs.com The MIT License

Extract javascript comments on per character basis. Comment object compatible with acorn-extract-comments and Esprima format.

Notice: It extracts only first level block comments, not include nested comments.

code climate standard code style travis build status coverage status dependency status

Install

npm i get-comments --save
npm test

Usage

For more use-cases see the tests

  • <input> {String} string to extract from
  • [resType] {Boolean} if true, will return array, otherwise object
  • return {Array|Object}

Example

var getComments = require('get-comments');

var input = fs.readFileSync('./fixture.js', 'utf8')
var comments = getComments(input, true)
//=>
// [ {
//   "start": 249,
//   "end": 1353,
//   "type": "Block",
//   "loc": {
//     "start": {
//       "line": 12,
//       "column": 0
//     },
//     "end": {
//       "line": 48,
//       "column": 3
//     }
//   },
//   "value": "*\n * > Filtering incoming request ...",
//   "api": true,
//   "after": "module.exports = function koaIpFilter (options) {"
// }, {
//   "start": 2187,
//   "end": 2267,
//   "type": "Block",
//   "loc": {
//     "start": {
//       "line": 82,
//       "column": 0
//     },
//     "end": {
//       "line": 87,
//       "column": 3
//     }
//   },
//   "value": "*\n * abcd description\n *\n * @name koaIpFilter\n * @param {Object} `options`\n ",
//   "api": false,
//   "after": "exports.data = function () {"
// } ]

See also

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
But before doing anything, please read the CONTRIBUTING.md guidelines.

Charlike Make Reagent new message to charlike freenode #charlike

tunnckocore.tk keybase tunnckocore tunnckoCore npm tunnckoCore twitter tunnckoCore github