JavaScript documentation look-up
PhpStorm shows you reference for standard JavaScript APIs, for symbols from your project and from its dependencies, as well as for symbols defined in external libraries. You can view the documentation for symbols in the Documentation popup, get information on method parameters, and open documentation on external sites if links to them are available.
For a project symbol or for a symbol from the project dependencies, PhpStorm generates the documentation from the corresponding JSDoc comment.
For a standard JavaScript object or method, PhpStorm shows the corresponding JSDoc comment from the built-in TypeScript definition files d.ts. These files are bundled with PhpStorm and updated on a regular basis.
If no comment is found in the d.ts files, PhpStorm shows a summary from the corresponding MDN article.
By default, documentation is shown in the Documentation popup but you can configure it to appear in the Documentation tool window.
Quick Documentation in a popup
![Quick Documentation in a popup](https://resources.jetbrains.com/help/img/idea/2022.1/ws_js_quick_doc_popup_706.png)
Hover the mouse over the necessary symbol in the editor.
Place the caret at the symbol and press Ctrl+Q or select
from the main menu.Press Ctrl+Q again to open this documentation in the Documentation tool window.
Click
in the popup to change the font size, display the quick documentation toolbar, or go to the source code.
Click in the popup to change the font size, display the quick documentation toolbar, or go to the source code. See Quick Documentation in a popup for details.
Quick Documentation in the tool window
![Quick Documentation Lookup in the tool window](https://resources.jetbrains.com/help/img/idea/2022.1/ws_js_quick_doc_tool_window_706.png)
With the default settings, pressing Ctrl+Q (
) opens quick documentation in a popup. You can change the settings to view documentation in the tool window.In the quick documentation popup, click
and disable the Show Documentation Popup First option.
In the Documentation tool window, click the
icon on the tool window toolbar and disable the Show Documentation Popup First option.
You can open a piece of documentation for a specific code element in the tool window and keep viewing documentation for other elements in your current file.
In the tool window, code documentation is displayed on the unpinned tab (the tab marked with the asterisk symbol (*
). You can view this documentation by hovering over a symbol or placing the caret at it. See Quick Documentation tool window: modes.
MDN documentation for symbols
In the Documentation popup Ctrl+Q, click the link at the bottom:
Press Shift+F1 or select
from the main menu.
PhpStorm opens the MDN article in the default PhpStorm browser.
Documentation for third-party JavaScript libraries
Download the required library or framework, configure it as an external JavaScript library, and specify the link to its external documentation, see Configuring a custom third-party JavaScript library for details.
Position the caret at the symbol and press Shift+F1 or choose
from the main menu.
Documentation for npm packages
In a package.json file or in a
require
orimport
statement, position the caret at the name of the package and press Ctrl+QTo open the documentation on the npm official website in the browser, press Shift+F1.