Skip to content

ghmcadams/vscode-lintlens

Repository files navigation

LintLens - VSCode extension

Visual Studio Marketplace Visual Studio Marketplace Visual Studio Marketplace The MIT License Twitter

Augment your ESLint rules in Visual Studio Code — Adds metadata and usage information beside each ESLint rule.


LintLens Screenshot

Features

Adds details beside each ESLint rule in your configuration file (including plugins) located anywhere in your workspace folders (supports multiple config files, and even multiple versions of ESLint and plugins).

Displays detailed information (including usage schema information and a link to the official docs page) in a hover container for each rule.

Adds intellisense (autocomplete) for rule IDs and for simple rule values (complex rule value intellisense MIGHT be added in the future)

Adds rule value validation

Supports all configuration file formats currently supported by ESLint

  • Flat Config - use eslint.config.js at the root and export an array containing your configurations.
  • JavaScript - use .eslintrc.js or .eslintrc.cjs (or any other javascript file in your workspace) and export an object containing your configuration.
  • YAML - use .eslintrc.yaml or .eslintrc.yml (or any other yaml file in your workspace) to define the configuration structure.
  • JSON - use .eslintrc.json (or any other JSON file in your workspace) to define the configuration structure. ESLint’s JSON files also allow JavaScript-style comments.
  • Deprecated - use .eslintrc, which can be either JSON or YAML.
  • package.json - create an eslintConfig property in your package.json file and define your configuration there.

If you are new to ESLint check the documentation.

Hover for more information on each rule:


LintLens Preview Hover

Autocomplete rules as you type:


LintLens Preview Main

Requirements

In an effort to support all possible plugins and to keep size small, this extension uses both ESLint and ESLint plugins installed in the opened workspace folder(s). Due to restrictions in vscode, this extension does not support globally installed packages.

Known Issues

  • ESLint v4.15.0 added an official location for rules to store a URL to their documentation in the rule metadata in eslint/eslint#9788. This adds the URL to all the existing rules so anything consuming them can know where their documentation is without having to resort to external packages to guess. If your plugin hasn't included this metadata, its possible you have an older version that needs to be updated.
  • Parsing js configs (flat and legacy) is somewhat limited, but should work in almost all cases.
    • Simple exporting of a config works
    • Exporting from a variable works
    • Finding rules through rest spread works
    • rule option validation does not work when variables are used
    • Beyond that, parsing could be improved
    • Additionally, the language mode must match javascript or javascriptreact.
  • Intellisense does not work for YAML config files
  • Rule option validation does not work for YAML config files
  • Can sometimes mistakenly activate for config files for other tools like stylelint and putout, which have similar config structures

About

Augment your ESLint rules in Visual Studio Code - Adds metadata beside each ESLint rule.

Resources

License

Stars

Watchers

Forks

Packages

No packages published