AppCode 2021.1 Help

JavaScript

AppCode also supports React, Angular, Vue.js, and other frameworks and provides tight integration with various tools for web development.

JavaScript-aware coding assistance includes completion for keywords, labels, variables, parameters, and functions, error and syntax highlighting, formatting, numerous code inspections and quick-fixes, as well as common and JavaScript-specific refactoring. AppCode also integrates with JavaScript linters and the Flow type checker.

With AppCode built-in debugger, you can debug both your client-side and server-side code and even run JavaScript code snippets in the interactive debugger console. Learn more from Debug JavaScript in Chrome.

AppCode integrates with Jest, Karma, Protractor, Cucumber, and Mocha testing frameworks. AppCode supports running and debugging tests as well as navigation between tests and subjects or between a failed test and the fragment of code that caused the problem.

Before you start

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

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 project by default.

  1. In the Preferences dialog ⌃⌥S, go to Languages and Frameworks | JavaScript. The JavaScript page opens.

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

    • ECMAScript 5.1

    • ECMAScript 6+: This version adds support for the features introduced in ECMAScript 2015-2020 and for JSX syntax as well as some current proposals to the standard.

    • Flow: This version adds support for the Flow syntax.

Using multiple JavaScript versions

If you are working on an application that uses both ECMAScript 5.1 and a newer version of ECMAScript, the easiest way is to choose the highest language version for the whole project from the list on the JavaScript page.

  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. AppCode 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 AppCode will use the version chosen on the JavaScript page.

    Choose JavaScript language version

JSX syntax in JavaScript code

If you are using JSX syntax in your JavaScript code, enable ECMAScript 6+.

  • In the Preferences dialog ⌃⌥S, go to Languages and Frameworks | JavaScript, and select ECMAScript 6+ from the JavaScript language version list.

  • To be warned when JSX syntax is used by mistake, open the Preferences dialog ⌃⌥S, go to Editor | Inspections, and enable the React JSX syntax inspection under JavaScript and TypeScript | General node. Use the search field to locate the inspection.

    Enable the React JSX syntax inspection

    Optionally, configure the inspection severity and scope. Learn more from Code inspections.

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 shown

Configure parameter hints

  1. Open the Preferences dialog ⌃⌥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, AppCode does not show parameter hints in any context. Click Exclude list... to view these methods and functions, possibly enable parameter hints for them, or add new items to the list.

Auto-import in JavaScript

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

Add ES6 imports on code completion

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

Autoimport with quick-fix: information tooltip

Alternatively, press ⌥⏎:

Autoimport with quick-fix: suggestion list

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

Autoimport with quick-fix: multiple choices

Learn more from Choosing the JavaScript language version.

Autoimport from project dependencies

Configure auto-import

  1. To automatically add ES6 import statements on code completion, open the Preferences dialog ⌃⌥S, go to Editor | General | Auto Import, and select the Add ES6 imports on code completion checkbox in the TypeScript/JavaScript area.

  2. To configure the appearance of import statements, open the Preferences dialog ⌃⌥S, go to Editor | Code Style | JavaScript, and use the controls in the Imports tab, see Imports tab for details.

Configuring syntax highlighting

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

  1. In the Preferences dialog ⌃⌥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 ⌥F2. Then select the desired browser from the list.

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

Debugging JavaScript

AppCode 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 AppCode, you can debug JavaScript applications running on the built-in server, on an external server, or on a remote server. For details, see Debug JavaScript in Chrome and Debug JavaScript in Firefox.

Last modified: 08 April 2021