IntelliJ IDEA 2019.3 Help

JavaScript

With IntelliJ IDEA, you can develop modern web, mobile, and desktop applications with JavaScript and Node.js.

IntelliJ IDEA supports JavaScript and TypeScript programming languages, React and Angular frameworks and provides tight integration with various tools for web development.

On this page you will find a short Getting Started Guide that will walk you step by step from creating a web application to debugging and testing it.

Before you start

Make sure the JavaScript and TypeScript bundled plugin is enabled on the Plugins page, see Managing plugins for details.

Creating a new application

  1. Select File | New | Project from the main menu or click the New Project button on the Welcome screen.

  2. In the New Project dialog, select Static Web in the left-hand pane.

  3. In the right-hand pane, choose Static Web again and click Next.

  4. On the second page of the wizard, specify the project name and the path to the folder where the project-related files will be stored. Click Finish.

Starting with an existing JavaScript application

If you are going to continue developing an existing JavaScript application, open it in IntelliJ IDEA, choose the JavaScript version to use, and configure the libraries in it. Optionally download the required npm dependencies.

To open the application sources that are already on your machine

  • Click Open on the Welcome screen or select File | Open from the main menu. In the dialog that opens, select the folder where your sources are stored.

To check out the application sources from your version control

  1. Click Get from Version Control on the Welcome screen or select VCS | Get from Version Control from the main menu.

  2. In the invoked dialog, select your version control system from the list and specify the repository to check out the application sources from.

Choosing the JavaScript language version

To get reliable and efficient coding assistance, you need to specify the language version that will be used in all JavaScript files of your application by default.

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

  2. From the list, choose one of the supported JavaScript language versions:

Using multiple JavaScript versions

If you are working on an application that uses both ECMAScript 5.1 and a newer version of ECMAScript, or JSX, or Flow, the easiest way is to choose the highest language version for the whole project from the list on the JavaScript page. For example, if you use ES5.1 and JSX, enable JSX (since it is a superset of ES5.1 and ES6).

To configure different JavaScript language versions for different folders

  1. On the JavaScript page, click the Browse button next to the JavaScript language version list. The JavaScript Language Versions dialog opens.

  2. Click Add and in the dialog that opens select the folder where you need a custom language version. IntelliJ IDEA brings you back to the JavaScript Language Versions dialog where the selected folder is shown in the Path field.

  3. From the Language list, choose the language version for the files in the selected folder. In all the other JavaScript files in the project IntelliJ IDEA will use the version chosen on the JavaScript page.

    ws_js_choose_language_version.png

Downloading npm dependencies

Before you start, make sure you have Node.js on your computer. If your application uses some tools, libraries, or frameworks, download the required packages.

To install a package in an empty project

  • In the embedded Terminal (Alt+F12), type:

    npm install <package name>.

If you already have a package.json file in your project

  • Right-click the package.json file in the editor or in the Project tool window and choose Run 'npm install' from the context menu.

  • Alternatively, run npm install in the Terminal Alt+F12.

Configuring code completion for project dependencies

To provide code completion for project dependencies, IntelliJ IDEA automatically creates a node_modules library. In IntelliJ IDEA, a library is a file or a set of files whose functions and methods are added to IntelliJ IDEA's internal knowledge in addition to the functions and methods that IntelliJ IDEA retrieves from the project code that you edit. See Configuring JavaScript Libraries and Code completion for details and examples.

Viewing parameter hints

Parameter hints show the names of parameters in methods and functions to make your code easier to read. By default, parameter hints are shown only for values that are literals or function expressions but not for named objects.

Parameter hints in JavaScript

To configure parameter hints

  1. Open the Settings/Preferences dialog Ctrl+Alt+S and go to Editor | Inlay Hints | JavaScript.

  2. Select Parameter hints from the list, make sure the Show parameter hints checkbox is selected, and then specify the context where you want parameter hints shown.

  3. For some methods and functions, IntelliJ IDEA does not show parameter hints in any context. Click Black list... to view these methods and functions, possibly enable parameter hints for them, or add new items to the list.

Auto import in JavaScript

IntelliJ IDEA can generate import statements for modules, classes, components, and any other symbols that are exported. If you are using ES6 in your project, IntelliJ IDEA can add missing import statements on the fly, when you complete ES6 symbols.

For earlier JavaScript versions or when auto-import on completion is disabled, IntelliJ IDEA marks the symbol as unresolved and shows a tooltip with the suggested quick-fix:

Autoimport with quick-fix: information tooltip

Alternatively, press Alt+Enter:

Autoimport with quick-fix: suggestion list

If there's more than one possible source of import, IntelliJ IDEA shows a list of suggestions:

Autoimport with quick-fix: multiple choices

Learn more from Choosing the JavaScript language version.

To add ES6 import statements on code completion

  1. In the Settings/Preferences dialog Ctrl+Alt+S, go to Editor | General | Auto-import. The Auto Import page opens.

  2. In the TypeScript/JavaScript area, select the Add ES6 imports on code completion checkbox.

IntelliJ IDEA can also generate import statements for symbols defined in the project’s dependencies. Auto-import works for symbols from packages that contain TypeScript definition files (like in moment or redux) or sources written as ES modules.

Configuring syntax highlighting

You can configure JavaScript-aware syntax highlighting according to your preferences and habits.

  1. In the Settings/Preferences dialog Ctrl+Alt+S, go to Editor | Color Scheme | JavaScript.

  2. Select the color scheme, accept the highlighting settings inherited from defaults or customize them as described in Configuring Colors and Fonts.

Running JavaScript in browser

  1. In the editor, open the HTML file with the JavaScript reference. This HTML file does not necessarily have to be the one that implements the starting page of the application.

  2. Do one of the following:
    • Choose View | Open in Browser from the main menu or press Alt+F2. Then select the desired browser from the list.

    • Hover your mouse pointer over the code to show the browser icons bar: Firefox Chrome Safari Internet Explorer Opera Click the icon that indicates the desired browser.

Debugging JavaScript

IntelliJ IDEA provides a built-in debugger for your client-side JavaScript code that works with Chrome.

You can also debug your client-side JavaScript in Firefox, version 36 and later. However it is strongly recommended that you use Chrome or any other browser of the Chrome family. With IntelliJ IDEA, you can debug JavaScript applications running on the built-in server, on an external server, or on a remote server. For details, see Debugging JavaScript in Chrome and Debugging JavaScript in Firefox.

Last modified: 26 April 2020