mirror of
https://github.com/github/codeql.git
synced 2026-01-27 21:33:03 +01:00
28 lines
963 B
Plaintext
28 lines
963 B
Plaintext
/**
|
|
* @name Undocumented parameter
|
|
* @description If some parameters of a function are documented by JSDoc 'param' tags while others
|
|
* are not, this may indicate badly maintained code.
|
|
* @kind problem
|
|
* @problem.severity recommendation
|
|
* @id js/jsdoc/missing-parameter
|
|
* @tags maintainability
|
|
* readability
|
|
* documentation
|
|
* @precision medium
|
|
*/
|
|
|
|
import javascript
|
|
|
|
from Function f, Parameter parm, Variable v, JSDoc doc
|
|
where
|
|
parm = f.getAParameter() and
|
|
doc = f.getDocumentation() and
|
|
v = parm.getAVariable() and
|
|
// at least one parameter is documented
|
|
exists(doc.getATag().(JSDocParamTag).getDocumentedParameter()) and
|
|
// but v is not
|
|
not doc.getATag().(JSDocParamTag).getDocumentedParameter() = v and
|
|
// don't report a violation in ambiguous cases
|
|
strictcount(JSDoc d | d = f.getDocumentation() and d.getATag() instanceof JSDocParamTag) = 1
|
|
select parm, "Parameter " + v.getName() + " is not documented."
|