https://github.com/microsoft/typescript-tslint-plugin

TypeScript TSLint language service plugin
https://github.com/microsoft/typescript-tslint-plugin

linter tslint typescript typescript-plugin

Last synced: about 2 months ago
JSON representation

TypeScript TSLint language service plugin

• Host: GitHub
• URL: https://github.com/microsoft/typescript-tslint-plugin
• Owner: microsoft
• License: mit
• Archived: true
• Created: 2018-08-21T13:36:25.000Z (about 6 years ago)
• Default Branch: main
• Last Pushed: 2023-05-01T20:48:49.000Z (over 1 year ago)
• Last Synced: 2024-07-08T13:56:27.941Z (3 months ago)
• Topics: linter, tslint, typescript, typescript-plugin
• Language: TypeScript
• Homepage:
• Size: 1.15 MB
• Stars: 282
• Watchers: 25
• Forks: 44
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - typescript-tslint-plugin - TypeScript TS Lint language service plugin (TypeScript)

README

        
# TypeScript TSLint Language Service Plugin

[![Build Status](https://travis-ci.org/Microsoft/typescript-tslint-plugin.svg?branch=master)](https://travis-ci.org/Microsoft/typescript-tslint-plugin)

> **❗IMPORTANT**: TSLint [has been deprecated](https://medium.com/palantir/tslint-in-2019-1a144c2317a9) in favor of ESLint and this plug-in has also been deprecated in favor of eslint.

>

> Please look into [migrating your projects to ESLint](https://github.com/typescript-eslint/typescript-eslint#typescript-eslint).

TypeScript [language service plugin](https://blogs.msdn.microsoft.com/typescript/2017/04/27/announcing-typescript-2-3/) for [TSLint][tslint].

To use the plugin:

* Install TSLint 5+ in your workspace or globally (if you are using a local TSLint, see [workspace library execution](#workspace-library-execution))

* Install the plugin with `npm install typescript-tslint-plugin` 

* Enable the plugin in your `tsconfig.json` file:

    ```json

    {

      "compilerOptions": {

        "plugins": [

          { "name": "typescript-tslint-plugin" }

        ]

      }

    }

    ```

See [editor support](#editor-support) for more detailed setup instructions.

## Workspace Library Execution

By default this plugin will not load TSLint or custom rules from the workspace if you are using a global version of TypeScript. This is done for security reasons. The plugin always allows using the global version of TSLint.

To use enable using a local TSLint install and custom rules from the workspace, you must either:

- Use a workspace version of TypeScript that is installed alongside TSLint.

- Enable workspace library execution in your editor of choice. This must be done through an editor and cannot be configured in a `tsconfig`.

    In VS Code for example, you can run the `TSLint: Manage Workspace Library Execution` command to enable using the TSLint for the current workspace or for all workspaces.

- Set a `TS_TSLINT_ENABLE_WORKSPACE_LIBRARY_EXECUTION=1` environment variable and make sure the TypeScript server is run in an environment where this variable is set to true.

## Configuration options

**Notice**: This configuration settings allow you to configure the behavior of the typescript-tslint-plugin itself. To configure rules and tslint options you should use the `tslint.json` file.

 * `configFile` - The configuration file that tslint should use instead of the default tslint.json. A relative file path is resolved relative to the project root.

 * `jsEnable` - Enable/disable tslint for `.js` files, default is `false`.

 * `ignoreDefinitionFiles` - Control if TypeScript definition files should be ignored. Default is `true`

 * `alwaysShowRuleFailuresAsWarnings` - Always show rule failures as warnings, ignoring the severity configuration in the tslint.json configuration. Default is `true`.

 * `suppressWhileTypeErrorsPresent` - Suppress tslint errors from being reported while other errors are present.

 * `exclude` - List of files to exclude from tslint.

 * `packageManager` - Package manager used, either: `npm`, `yarn`, or `pnpm`. This is currently only used for error message instructions about how to install tslint. Default is `npm`.

 

Here is a configuration sample:

```json

{

  "compilerOptions": {

    "plugins": [

      {

        "name": "typescript-tslint-plugin",

        "alwaysShowRuleFailuresAsWarnings": false,

        "ignoreDefinitionFiles": true,

        "configFile": "../tslint.json",

        "suppressWhileTypeErrorsPresent": false

      }

    ]

  }

}

```

**Notice**: due to an issue in the implementation of the `no-unused-variable` rule ([palantir/tslint#2469](https://github.com/palantir/tslint/issues/2649)), this rule will be disabled by the plugin. You can use the typescript compiler options `noUnusedLocals` and `noUnusedParameters` instead. 

# Editor Support

This plugin requires TypeScript 3.0 or later. It can provide intellisense in both JavaScript and TypeScript files within any editors that uses TypeScript to power their language features.

## With VS Code

*If you also have the [vscode-tslint](https://marketplace.visualstudio.com/items?itemName=eg2.tslint) extension in VS Code installed, please disable it to avoid that files are linted twice.*

The simplest way to use this plugin is to install the [TypeScript TSLint Plugin VS Code extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-typescript-tslint-plugin). This extension enables the plugin when using VS Code's version of TypeScript.

If you are using a workspace version of TypeScript, you must manually install the plugin alongside the version of TypeScript in your workspace:

```bash

npm install --save-dev typescript-tslint-plugin typescript

```

Then add a `plugins` section to your [`tsconfig.json`](http://www.typescriptlang.org/docs/handbook/tsconfig-json.html) or [`jsconfig.json`](https://code.visualstudio.com/Docs/languages/javascript#_javascript-project-jsconfigjson)

```json

{

  "compilerOptions": {

    "plugins": [

      {

        "name": "typescript-tslint-plugin"

      }

    ]

  }

}

```

Finally, run the `Select TypeScript version` command in VS Code to switch to use the workspace version of TypeScript for VS Code's JavaScript and TypeScript language support. You can find more information about managing typescript versions [in the VS Code documentation](https://code.visualstudio.com/Docs/languages/typescript#_using-newer-typescript-versions).

![Usage with VS Code](documentation/example-vscode.png)

The most important differences between the `vscode-tslint` extension and `typescript-tslint-plugin` are:

* The plugin shares the program representation with TypeScript. This is more efficient than the `vscode-tslint` extension which needs 

  to reanalyze the document.

* Since `vscode-tslint` lints one file a time only, it cannot support tslint rules that require the type checker. The plugin doesn't have this limitation.

* `vscode-tslint` provides additional [features](https://marketplace.visualstudio.com/items?itemName=eg2.tslint), please file issue requests for the features you are missing.

### With Atom

This plugin works with the [Atom TypeScript plugin](https://atom.io/packages/atom-typescript).

First install the plugin and a copy of TypeScript in your workspace:

```bash

npm install --save-dev typescript-tslint-plugin typescript

```

Then add a `plugins` section to your [`tsconfig.json`](http://www.typescriptlang.org/docs/handbook/tsconfig-json.html) or [`jsconfig.json`](https://code.visualstudio.com/Docs/languages/javascript#_javascript-project-jsconfigjson) and restart Atom.

```json

{

  "compilerOptions": {

    "plugins": [

      {

        "name": "typescript-tslint-plugin"

      }

    ]

  }

}

```

![Usage with atom](documentation/example-atom.png)

### With Sublime

This plugin works with the [Sublime TypeScript plugin](https://github.com/Microsoft/TypeScript-Sublime-Plugin).

First install the plugin and a copy of TypeScript in your workspace:

```bash

npm install --save-dev typescript-tslint-plugin typescript

```

And configure Sublime to use the workspace version of TypeScript by [setting the `typescript_tsdk`](https://github.com/Microsoft/TypeScript-Sublime-Plugin#note-using-different-versions-of-typescript) setting in Sublime:

```json

{

  "typescript_tsdk": "/Users/me/my-amazing-project/node_modules/typescript/lib"

}

```

Finally add a `plugins` section to your [`tsconfig.json`](http://www.typescriptlang.org/docs/handbook/tsconfig-json.html) or [`jsconfig.json`](https://code.visualstudio.com/Docs/languages/javascript#_javascript-project-jsconfigjson) and restart Sublime.

```json

{

  "compilerOptions": {

    "plugins": [

      {

        "name": "typescript-tslint-plugin"

      }

    ]

  }

}

```

![Usage with Sublime](documentation/example-sublime.png)

### With Visual Studio

This plugin works [Visual Studio 2017](https://www.visualstudio.com) using the TypeScript 2.5+ SDK.

First install the plugin in your project:

```bash

npm install --save-dev typescript-tslint-plugin

```

Then add a `plugins` section to your [`tsconfig.json`](http://www.typescriptlang.org/docs/handbook/tsconfig-json.html).

```json

{

  "compilerOptions": {

    "plugins": [

      {

        "name": "typescript-tslint-plugin"

      }

    ]

  }

}

```

Then reload your project to make sure the plugin has been loaded properly. Note that `jsconfig.json` projects are currently not supported in Visual Studio.

### With vim and neovim

Use [coc-tslint-plugin](https://github.com/neoclide/coc-tslint-plugin) as extension of [coc.nvim](https://github.com/neoclide/coc.nvim).

Run command in your vim after coc.nvim installed:

```

:CocInstall coc-tsserver coc-tslint-plugin

```

Run command `:CocConfig` to open configuration file.

# Contributing

To build the typescript-tslint-plugin, you'll need [Git](https://git-scm.com/downloads) and [Node.js](https://nodejs.org/).

First, [fork](https://help.github.com/articles/fork-a-repo/) the typescript-tslint-plugin repo and clone your fork:

```bash

git clone https://github.com/YOUR_GITHUB_ACCOUNT_NAME/typescript-tslint-plugin.git

cd typescript-tslint-plugin

```

Then install dev dependencies:

```bash

npm install

```

The plugin is written in [TypeScript](http://www.typescriptlang.org). The source code is in the `src/` directory with the compiled JavaScript output to the `lib/` directory. Kick off a build using the `compile` script:

```bash

npm run compile

```

Please also see our [Code of Conduct](CODE_OF_CONDUCT.md).

## VS Code

To test the newly compiled program, open the `test-workspace` folder in VS Code and use the TypeScript version picker to [switch to the local version of TypeScript](https://code.visualstudio.com/Docs/languages/typescript#_using-newer-typescript-versions).

To debug you use two versions of VS Code, e.g., the stable and the insider version. The idea is that one of them is configured to support attaching a debugger to the Typescript language server:

- Use the insider version for development and open it on the typescript-tslint-plugin workspace.

- Use the stable version for debugging opened on the `test-workspace` folder of the tslint-language service.

To setup the stable version for debugging, you need to set the environment variable `TSS_DEBUG` to port 5859. In a command prompt/shell:

- make sure that the stable version isn't running already

- `set TSS_DEBUG=5859`

- cd to the `dev` folder

- `code .`

To debug the plugin press `F5`. The `dev` workspace has a launch configuration that attaches through port 5859 to the language server. 

# Credits

This project was forked from  https://github.com/angelozerr/tslint-language-service which itself is based on https://github.com/Microsoft/vscode-tslint/

[tslint]: https://github.com/palantir/tslint