Creating JSDoc Comments
PhpStorm helps you create JSDoc comments and uses them for JavaScript Documentation Lookup with Ctrl+Q. PhpStorm recognizes TODO patterns and Closure Compiler annotations inside documentation comments and uses them in code completion, intention actions, and other types of coding assistance.
Find a detailed description of the JSDoc syntax with examples in An Introduction to JSDoc.
To enable JSDoc comments
-
In the Settings/Preferences dialog Ctrl+Alt+S, go to .
-
In the Enter area, select the Insert documentation comment stub checkbox.
To create a JSDoc comment
-
Position the caret before the declaration of the method/function or field to document, type the opening block comment
/**
, and press Enter. Describe the listed parameters, return values, and so on. -
Alternatively, use the dedicated Fix Doc Comment action. Position the caret at the method/function or field to document, press Ctrl+Shift+A and start typing
Fix Doc Comment
. Then select Fix Doc Comment from the list, and press Enter.