eslint-plugin-jsdoc

JSDoc specific linting rules for ESLint.

OTHER License

Downloads
9.7M
Stars
1.1K
Committers
104

Bot releases are hidden (Show)

eslint-plugin-jsdoc - v32.0.1

Published by gajus over 3 years ago

32.0.1 (2021-02-16)

Bug Fixes

  • default to u flag for checkTypesPattern option for require-param, check-param-names; for check-values, default to u flag and allow slashed regexes with own flags; for match-description, allow slashed regexs with own flags; for all of the previous (and check-examples) allows newlines (4f0dc8e)
eslint-plugin-jsdoc - v32.0.0

Published by gajus over 3 years ago

32.0.0 (2021-02-15)

Bug Fixes

  • check-examples: change default extension for simulated file name of [@example](https://github.com/example) from md to md/*.js. Only applies when matchingFileName is not used. (2cc1227)

BREAKING CHANGES

  • check-examples: Per update to eslint-plugin-markdown v2 and its support of ESLint 7's new processor API, fenced blocks can (and must) be targeted separately from the Markdown parent file as a whole, so in order to allow the same overrides config to be reusable between Markdown fenced blocks and @example tags (since one often wishes to disable the same kind of rules for each, being as that each may deliberately lack full context, e.g., undefined or unused variables), we update the default simulated extension set for @example tags by check-examples to simulate an expression which will now be a suitable choice for overrides in targeting Markdown fenced blocks using the new parser API, as with eslint-plugin-markdown@2 (i.e., "md/*.js" instead of "md").

If you need to use ESLint 6 (or eslint-plugin-markdown < 2, for example) with check-examples, you should be able to manually supply the matchingFileName option targeting "md", e.g., set to 'dummy.md.

This commit also simplifies a testing example to avoid it throwing with changed config not having proper babel support (not meaningful to test anyways)

eslint-plugin-jsdoc - v31.6.1

Published by gajus over 3 years ago

31.6.1 (2021-02-07)

Bug Fixes

eslint-plugin-jsdoc - v31.6.0

Published by gajus over 3 years ago

31.6.0 (2021-01-31)

Bug Fixes

  • require-returns, require-yields: support more AST checking (6fd8a07)
  • require-yields: avoid checking nested generators (as with functions) (b9058e4)
  • return-yields, return-yields-check: allow generator detection on exported; handle more AST types; fixes #682 (4e768aa)

Features

  • require-returns-check: add exemptAsync option (0ed24c0)
eslint-plugin-jsdoc - v31.5.0

Published by gajus over 3 years ago

31.5.0 (2021-01-31)

Bug Fixes

  • require-returns: check labeled statements (51f37f1)
  • require-throws: check labeled statements (ceadcfe)
  • require-yields: check test part of if expression and check conditionals (db001be)
  • require-yields: check labeled statements (aceb7a0)

Features

  • require-returns: if function returns a Promise whose executor resolves with undefined, avoid need to document unless forceReturnsWithAsync is set; fixes #550 (565fdbd)
eslint-plugin-jsdoc - v31.4.0

Published by gajus over 3 years ago

31.4.0 (2021-01-27)

Bug Fixes

  • check-line-alignment: escape user tag name in regex (c0ae4cb)

Features

  • check-line-alignment: allow tags option to configure which tags should be aligned. (780b8b5)
eslint-plugin-jsdoc - v31.3.3

Published by gajus over 3 years ago

31.3.3 (2021-01-25)

Bug Fixes

  • check-line-alignment: apply alignment to return tags and avoid possibility for "never" option to insert extra space with returns/return as well as handle missing type (cb39556)
eslint-plugin-jsdoc - v31.3.2

Published by gajus over 3 years ago

31.3.2 (2021-01-24)

Bug Fixes

  • while a fix provided for decorator detection and useful for inserting empty jsdoc blocks when fixers are enabled, it appears to have a 25% or so degradation in performance when tested with a large repository, so reverting. (e08d889)

Reverts

  • Revert "optimize: ensure with new fix that we avoid checking back too far" (0fc4663)
eslint-plugin-jsdoc - v31.3.1

Published by gajus over 3 years ago

31.3.1 (2021-01-24)

Bug Fixes

  • bug with false positive decorator detection (evident sans semi-colons); e.g., require-jsdoc fixer (6bda6b4)
eslint-plugin-jsdoc - v31.3.0

Published by gajus over 3 years ago

31.3.0 (2021-01-24)

Features

  • check-param-names: add options disableExtraPropertyReporting to allow extra properties to be documented without error (as long as there are no siblings destructured as for such cases, they will still be expected since the function is not using them) (8b2d143)
eslint-plugin-jsdoc - v31.2.3

Published by gajus over 3 years ago

31.2.3 (2021-01-24)

Bug Fixes

  • require-param, check-param-names: add option useDefaultObjectProperties for expecting documentation or avoiding reporting of documented; addresses part of #676 (a36faf2)
eslint-plugin-jsdoc - v31.2.2

Published by gajus over 3 years ago

31.2.2 (2021-01-23)

Bug Fixes

  • check-tag-names: should have previously auto-allowed settings.jsdoc.structuredTags tags (5f586fd)
eslint-plugin-jsdoc - v31.2.1

Published by gajus over 3 years ago

31.2.1 (2021-01-23)

Bug Fixes

  • caps issue with require-yields-check rule (6b8d0d8)
eslint-plugin-jsdoc - v31.2.0

Published by gajus over 3 years ago

31.2.0 (2021-01-23)

Features

  • require-yields-check: add rule to check that yield (of proper form) is present in the function body; fixes #354 (acf9529)
eslint-plugin-jsdoc - v31.1.0

Published by gajus over 3 years ago

31.1.0 (2021-01-23)

Features

  • require-yields: add new rule to check that yield has documentation; for #354 (e06fddd)
  • require-yields: add options to check that next has documentation (15daa12)
eslint-plugin-jsdoc - v31.0.8

Published by gajus over 3 years ago

31.0.8 (2021-01-20)

Bug Fixes

  • no-undefined-types: support true and false literals (b8cb394)
eslint-plugin-jsdoc - v31.0.7

Published by gajus almost 4 years ago

31.0.7 (2021-01-18)

Bug Fixes

  • ensure accurate parsing of names after multi-line types; fixes #669 (7b9c1bd)
eslint-plugin-jsdoc - v31.0.6

Published by gajus almost 4 years ago

31.0.6 (2021-01-17)

Bug Fixes

  • update comment-parser to surface restoration of support for equal signs in defaults and multi-line types; fixes #669; fixes #673 (081d7eb)
eslint-plugin-jsdoc - v31.0.5

Published by gajus almost 4 years ago

31.0.5 (2021-01-14)

Bug Fixes

  • require-description-complete-sentence: regression re: not trimming of description for check as relevant to tag description checking; fixes #672 (d81caa2)
eslint-plugin-jsdoc - v31.0.4

Published by gajus almost 4 years ago

31.0.4 (2021-01-14)

Bug Fixes

  • restore trim as relevant to tag description checking; fixes #670 (9f69c36)
Package Rankings
Top 0.88% on Npmjs.org
Top 6.73% on Proxy.golang.org
Badges
Extracted from project README
NPM version Travis build status js-canonical-style Discord Chat