WebStorm 2020.3 Help

Code completion

Code completion is one of the essential features of the WebStorm editor. To show you completion suggestions, WebStorm goes through the project files with the source code and adds classes, methods, functions, and variables defined in them to a special internal index. Additional information from JSDoc comments, TypeScript type definitions, and so on can also significantly improve completion.

Completion also works for symbols from third-party code. In most cases all you need is to add the required files to your project, see Configuring JavaScript Libraries for details.

This section covers various techniques of context-aware code completion that allow you to speed up your coding process.

ws_react_classname.png

Basic completion

Basic code completion helps you complete the names of classes, methods, fields, and keywords within the visibility scope. When you invoke code completion, WebStorm analyses the context and suggests the choices that are reachable from the current caret position (suggestions also include Live templates).

Invoke basic completion

  1. Start typing a name. By default, WebStorm displays the code completion popup automatically as you type.

    Completion popup
    If automatic completion is disabled, press Ctrl+Space or choose Code | Code Completion | Basic from the main menu.

  2. To get more suggestions, press Ctrl+Space for the second time (or press Ctrl+Alt+Space ).

  3. To narrow down the suggestions list, type any part of the expected name or keyword (even characters from somewhere in the middle are accepted) or invoke code completion after a dot separator. WebStorm shows the suggestions that include the typed characters in any positions.

    Suggestions list narrowed down as you type

Accept a suggestion from the list in one of the following ways

  • Press Enter or double-click the relevant list item to insert it to the left of the caret.

  • Press Tab to replace the characters to the right from the caret.

  • Use Ctrl+Shift+Enter to make the current code construct syntactically correct (balance parentheses, add missing braces and semicolons, and so on).

  • Use specific language and context-dependent keys to insert the selected completion suggestion, see Configuring completion settings for details.

View reference for the selected suggestion

  • For quick documentation look-up, select an item in the suggestion list and press Ctrl+Q. WebStorm shows you quick documentation for it in the Documentation popup.

    Basic completion: documentation look-up
  • To view the documentation in a tool window with more controls, pin the Documentation popup. To switch between the Documentation popup and the Documentation tool window, press Ctrl+Q sequentially.

  • To view the definition of the selected suggestion, press Ctrl+Shift+I.

    Basic completion: definition look-up

View code hierarchy

Select an entry in the suggestions list and press one of the following shortcuts:

  1. Ctrl+H to view type hierarchy

  2. Ctrl+Alt+H to view view call hierarchy.

  3. Ctrl+Shift+H to view method hierarchy.

See Building hierarchies for details.

Suggestions for the names of new variables and parameters

Besides completing calls of existing symbols, WebStorm can suggest names for new variables and parameters during their declaration. These suggestions are based on the names of classes, types, and interfaces that are defined in your project, in the libraries you are using, and in standard APIs.

By default, this functionality is off. To turn it on, open the Settings/Preferences dialog Ctrl+Alt+S, go to Editor | General | Code Completion, and select the Suggest variable and parameter names checkbox in the JavaScript section.

Suggested names for a newly declared variable

Completion from the TypeScript Language Service in JavaScript

You can enhance basic code completion in JavaScript files by using suggestions from the TypeScript Language Service. Learn more from Verifying TypeScript.

  1. Open a jsconfig.json or tsconfig.json file and add 'allowJS' : true to it.

  2. In the Settings/Preferences dialog Ctrl+Alt+S, go to Languages and Frameworks | TypeScript.

  3. On the TypeScript page that opens, make sure the TypeScript Language Service checkbox is selected.

Statement completion

You can create syntactically correct code constructs by using statement completion Ctrl+Shift+Enter. It inserts the necessary syntax elements (parentheses, braces, and semicolons) and gets you in a position where you can start typing the next statement.

Completing a method declaration and the code constructs inside it

Complete method declarations

  • Start typing a method or function declaration and press Ctrl+Shift+Enter. WebStorm creates an entire construct of a method and places the cursor inside the method body.

    Complete a method declaration
  • Alternatively press Ctrl+Shift+Enter later, after the opening parenthesis.

Complete code constructs

  • Start typing a code construct, for example, type if, and press Ctrl+Shift+Enter. WebStorm automatically adds the required punctuation and places the cursor at the next edit point.

    Complete an if statement

Hippie completion

Hippie completion is a completion engine that analyses your text in the visible scope and generates suggestions from the current context. It helps you complete any word from any of the currently opened files.

Expand a string at caret to an existing word

  1. Type the initial string and do one of the following:

    • Press Alt+/ or choose Code | Code Completion | Cyclic Expand Word to search for matching words before the caret.

    • Press Alt+Shift+/ or choose Code | Code Completion | Cyclic Expand Word (Backward) to search for matching words after the caret and in other open files.

    The first suggested value appears, and the prototype is highlighted in the source code.

  2. Accept the suggestion, or hold the Alt key and keep pressing / until the desired word is found.

Hippie completion

Postfix code completion

Postfix code completion helps you reduce backward caret jumps as you write code. You can transform an already-typed expression to a different one based on a postfix you type after the dot, the type of expression, and its context.

WebStorm is shipped with a set of predefined postfix templates and lets you define your own custom ones for JavaScript and TypeScript.

Custom templates can be copied, updated, and removed. For predefined templates you can only change their postfixes, for example to replace a long key with a shorter one.

Learn more from JavaScript postfix templates.

  • To view a full list of available postfix templates, in the Settings/Preferences dialog Ctrl+Alt+S, go to Editor | General | Postfix Completion.

    Learn more from Activating postfix completion.

  • Select Tab, Space, or Enter to expand postfix templates.

Create custom postfix templates

  1. In the Settings/Preferences dialog Ctrl+Alt+S, go to Editor | General | Postfix Completion.

  2. Click the Add button (the Add button) on the toolbar. From the popup list that opens, select whether you want to create a template only for TypeScript or both for JavaScript and TypeScript.

  3. Specify the Key that is the combination of symbols that will invoke the template, for example, write. Select which expression types the new template will be applicable to, and type the target expression in the following format: $EXPR$ <target_expression>, for example, document.write("The result is: " + $EXPR$ + "");.

    Add $END$ where you want the caret to be placed after the template is applied, for example:

    document.write("The result is: " + $EXPR$ + "$END$");
  4. By default, if an invoked template is technically applicable to several expressions, WebStorm prompts you to select the one you need.

    Postfix Completion: select expression

    To have WebStorm automatically transform the topmost applicable expression when the template is invoked, select the Apply to the topmost expression checkbox.

Completion of overrides

When you want to override a method from the parent class or interface and select this method from the list of completion suggestions, WebStorm automatically adds parameters, generates a super() call, and adds the type information, if possible.

Completing overrides: generating the method body

To turn off generation of method bodies for overrides

  1. In the Settings/Preferences dialog Ctrl+Alt+S, go to Languages and Frameworks | JavaScript.

  2. On the JavaScript page that opens, clear the Expand method bodies in completion for overrides checkbox.

Completion of tags, attributes, and properties

WebStorm automatically completes names and values of tags and attributes in many file types:

Completion of tags and attribute names is based on the DTD or Schema the file is associated with. If there is no schema association, WebStorm will use the file content (tag and attribute names and their values) to complete your input.

  1. Press < and start typing the tag name. WebStorm displays the list of tag names appropriate in the current context.

    Use the Up and Down buttons to scroll through the list.

  2. Press Enter to accept a selection from the list. If your file is associated with a schema or a DTD, WebStorm automatically inserts the mandatory attributes according to it.

Completing HTML tags and attributes

Configuring code completion settings

To customize the default completion behavior, open the Settings/Preferences dialog Ctrl+Alt+S, go to Editor | General | Code Completion, and on the Code Completion page update the default completion settings. To tune completion in the JavaScript context, use the controls in the JavaScript area.

Display the suggestions list automatically as you type

  • Select the Show suggestions as you type checkbox. If the checkbox is cleared, you have to call code completion explicitly by pressing Ctrl+Space for basic completion or Ctrl+Shift+Space for smart completion.

    You can also choose to automatically insert suggestions when there's just one option: select the completion type under Automatically insert single suggestions for.

Show suggestions in the alphabetic order

  • Select the Sort suggestions alphabetically checkbox. By default the checkbox is cleared and suggestions are sorted by their relevance.

  • Alternatively use Sort Alphabetically or sort by relevance in the lower-right corner of the suggestions list to toggle these modes. Note that these icons appear are not displayed for lists containing just a few entries.

Include suggestions in the list with respect to case

  • Select the Match case checkbox and choose whether you want to match case for first letters only, or for all letters.

Turn on automatic documentation look-up

Use specific keys to insert suggestions

  • Select the Insert selected suggestion by pressing space, dot, or other context-dependent keys checkbox. These keys depend on the language and the context where completion is invoked.

Sort suggestions based on Machine Learning

You can use machine learning models to get more accurate completion suggestions for your JavaScript and TypeScript code.

  • To show most suitable items higher in the suggestions list, select the Rank completion suggestions based on Machine Learning checkbox.

Configure completion for JavaScript

Besides common settings for completion behaviour, you can configure some JavaScript-specific options.

  • WebStorm suggests completion for symbols regardless of their types. With this approach, in complicated cases the list shows multiple completion variants.

    To make completion more precise, select Only type-based completion. The completion list will strongly depend on the WebStorm inference. As a result, the list may remain empty in case of poor inference.

  • WebStorm suggests completion for symbols with the optional chaining operator (?).

    To suppress this behavior, clear the Suggest items with optional chaining for nullable types checkbox.

  • When you want to override a method from the parent class or interface and select this method from the list of completion suggestions, WebStorm automatically adds parameters, generates a super() call, and adds the type information, if possible.

    Clear the Expand method bodies in completion for overrides checkbox to suppress automatic generation of method bodies for overrides during completion.

  • Configure completion for names:

    • Suggest variable and parameter names: By default, the checkbox is cleared. When it is selected, WebStorm suggests names for new variables and parameters during their declaration. These suggestions are based on the names of classes, types, and interfaces that are defined in your project, in the libraries you are using, and in standard APIs.

    • Suggest names for class fields

      The option is turned off by default.

    • Add type annotations for suggested parameter names: Select this checkbox to supply each completion suggestion with information on its type.

      The checkbox is available only when the Suggest variable and parameter names checkbox is selected.

  • Configure how parameter information is shown when you examine or accept a suggestion.

    • Show the parameter info popup (in ms): Select this checkbox to have WebStorm automatically show a popup with all available method signatures when an opening bracket is typed in the editor, or a method is selected from the suggestions list.

      In the text field to the right, specify the delay (in milliseconds) after when the popup window should appear.

      If this checkbox is not selected, use Ctrl+P to show parameter info.

    • Show full method signatures: If this checkbox is selected, the parameter info displays full signatures, including method name and returned type.

Completing a path

This type of completion speeds up selection of files and folders. The dialog used for that purpose is called rather often, for example, when you specify the installation folder of an external tool or a Version Control engine or configure a Node.js interpreter.

  1. Open the Select Path dialog by choosing Open File on the File menu or by clicking Browse the Browse button next to the field where a path is required.

  2. Make sure that the Path field is visible. If the field is hidden, click the Show path link.

  3. Start typing a path. WebStorm suggests a list where you can quickly find the needed directory.

    As you type, the suggestion list shrinks to show the matching paths only.

    You can also press Ctrl+Space to show the suggestion list.

  4. Select the relevant suggestion from the list.

Completing path

Troubleshooting

If code completion doesn't work, this may be due to one of the following reasons:

  • The Power Save Mode is on (File | Power Save Mode ). Turning it on minimizes power consumption of your laptop by eliminating the background operations, including error highlighting, on-the-fly inspections, and code completion.

  • Your file doesn't reside in a content root, so it doesn't get the required class definitions and resources needed for code completion.

  • The file with the symbols to be used in code completion is marked as a plain text file.

  • The third-party file with the symbols to be used in code completion is not configured as an external JavaScript library.

Last modified: 08 March 2021