IntelliJ Plugin

• Windows
• Linux

• IntelliJ IDEA 2020.3 ~ 2023.1 version
• WebStorm

• Oracle JRE 8 and above
• OpenJDK 8 and above

In File > Settings > Plugins settings, click Install Plugin from Disk... menu and select the DeepScan plugin (*.jar or *.zip).

The plugin will be installed after restarting the IDE. You can see the installed plugin in Plugins.

A license key is required to run the IntelliJ DeepScan plugin. If a valid license key is not registered, license errors will occur when executing the analysis.

In File > Settings > Language & Frameworks > JavaScript > Code Quality Tools > DeepScan (Global) settings, enter and save the license key in the License field.

With an upgraded plugin file, follow the same process as installing.

In File > Settings > Plugins settings, select the DeepScan plugin. Then, press Delete key or select Uninstall menu from the pop-up menu.

The plugin will be uninstalled after restarting the IDE.

DeepScan plugin works based on IntelliJ's Code Inspection.

It supports both the local and global inspection, so you can instantly analyze your code as you type and even analyze your entire project.

• Analyzing an entire project: When you click Code (or Analyze) > Inspect Code... menu
• Analyzing a file on-the-fly: When you type in the editor

For detailed information about the analysis target, refer to the following:

• Supported file types for the analysis
• Excluded files by default

You can also analyze a whole project rather than a file on-the-fly.

1. Click Code (or Analyze) > Inspect Code... menu.
2. Select the Inspection scope and click Analyze button.
   
3. You can see the analysis results in JavaScript > Code Quality Tools > DeepScan under Inspection Results view.
   

Running DeepScan only

As of Code Inspection, other inspection tools are also executed, so that the analysis can take a long time. If you want to run DeepScan only, you can create a separate inspection profile for it.

1. Click Configure... button in Inspection profile.
   
2. Click Duplicate... menu to create a new profile cloning the current profile, and enter a name.
   
3. Click Reset to Empty button to disable all inspection tools.
   
4. Only check the DeepScan inspection (you can filter by typing deepscan) and click OK button.
   
5. Inspect a project with this new profile.
   

Enable or disable DeepScan inspection for the project.

You can choose the rules to exclude for the analysis in the project settings.

Find the rules to exclude, uncheck those, and click OK button. Afterwards, the analysis will ignore the rules.

In the toolbar menu under the rule settings, you can export the rule set in use and import it from a file.

By sharing the exported file, you can share your own rule set with other people.

• Export: Click Export Rules button and specify a directory to export the file. Currently selected rule set is saved as a DeepScan_rules.json file.
• Import: Click Import Rules button and select the exported file (*.json). Rule set in a file is applied.

You can specify patterns of files/directories to exclude in the project settings.

It is a comma-separated paths, and each pattern follows the gitignore format. Below are some examples:

After the patterns is set, the files or directories will be ignored when inspecting the project.

You can apply these ignore patterns also for ESLint by selecting Apply also to ESLint checkbox.

You can see the ESLint alarms together with DeepScan's issues by running ESLint configured in your project.

To enable this feature, check ESLint > Enable in the project settings.

• ESLint package is required in the local or global. NODE_PATH environment variable is necessary to load the ESLint module installed in global.
• ESLint configuration files (.eslintrc.json files) located in your project are directly used and you can use custom plugins as is.
• You can choose how identical issues of DeepScan and ESLint are merged. In Merge option, choose one of the following:
  • Prefer DeepScan rule: Show only DeepScan issues (default)
  • Prefer ESLint rule: Show only ESLint issues
  • Do not merge: Show all issues as is
• Node.js is required to run ESLint package. Specify Node.js executable path in Node interpreter option when you don't have it in the PATH.

While you can exclude project-wide rules via Settings, you can also disable a rule in a file using the following inline comments:

Below is an example of disabling all rules for a line via deepscan-disable-line comment.

For detailed information, refer to Disabling rules.

You can enter inline comments more conveniently through code completion.

When you type an inline comment and press Ctrl + Space key, DeepScan suggests the suppress comments. When you select one, it is automatically entered.

You can also enter inline comments through Quick Fix for DeepScan issues.

When you press Alt + Enter key in DeepScan issues, some quick fixes are suggested. Select Ignore this rule <rule>, then the inline comment disabling the rule is automatically entered.

DeepScan has a long roadmap to provide an auto fix feature, which automatically modifies the non-compliant code into compliant one.

As an experiment, the plugin provides a simple auto fix for the two rules:

Rule	Fix Action
ASSIGN_SAME_VALUE	Remove the assignment
BAD_ASSIGN_TO_CONST	Change const to var / Remove the assignment