Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gund/eslint-plugin-deprecation
ESLint rule that reports usage of deprecated code
https://github.com/gund/eslint-plugin-deprecation
Last synced: 16 days ago
JSON representation
ESLint rule that reports usage of deprecated code
- Host: GitHub
- URL: https://github.com/gund/eslint-plugin-deprecation
- Owner: gund
- License: lgpl-3.0
- Created: 2020-02-16T23:04:06.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-31T22:26:47.000Z (5 months ago)
- Last Synced: 2024-10-10T06:07:58.398Z (29 days ago)
- Language: TypeScript
- Size: 604 KB
- Stars: 329
- Watchers: 8
- Forks: 38
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-eslint - deprecation - Identifies use of (Plugins / Deprecation)
README
# Rule has migrated
Rule had been added to [`typescript-eslint`](https://github.com/typescript-eslint/typescript-eslint) project and the docs can be found [here](https://typescript-eslint.io/rules/no-deprecated).
This repo is no longer maintained and is archived.
# eslint-plugin-deprecation
[](https://github.com/gund/eslint-plugin-deprecation/actions/workflows/test.yml)
[](https://github.com/gund/eslint-plugin-deprecation/actions/workflows/release.yml)
[](https://codeclimate.com/github/gund/eslint-plugin-deprecation/maintainability)
[](https://www.npmjs.com/package/eslint-plugin-deprecation)
[](https://www.npmjs.com/package/eslint-plugin-deprecation)
[](https://github.com/gund/eslint-plugin-deprecation/blob/master/LICENSE)
[](https://github.com/semantic-release/semantic-release)
> An [ESLint](https://eslint.org/) plugin with rules reporting usage of deprecated code
## Prerequisites
If you already use [TypeScript](https://www.typescriptlang.org/) and one or more rules from the [`typescript-eslint`](https://typescript-eslint.io/) plugin, then `eslint-plugin-deprecation` will work out of the box without any additional dependencies or special configuration specified in this section. (This is because `@typescript-eslint/plugin` automatically contains `@typescript-eslint/parser` and your ESLint should already be configured with the `parserOptions` to work properly with TypeScript.)
Otherwise, in order for you to use this plugin, you must also install the following dependencies:
- `typescript`
- `@typescript-eslint/parser`
For example, if you use the `npm` package manager, then you would run the following command in the root of your project:
```sh
npm install --save-dev typescript @typescript-eslint/parser
```
Next, you must configure ESLint to parse TypeScript and include type information:
```jsonc
{
"parser": "@typescript-eslint/parser",
"parserOptions": {
"ecmaVersion": 2020,
"sourceType": "module",
"project": "./tsconfig.json" // <-- Point to your project's "tsconfig.json" or create a new one.
}
}
```
## Install
For example, if you use the `npm` package manager, then you would run the following command in the root of your project:
```sh
npm install --save-dev eslint-plugin-deprecation
```
## Setup
### Using the `recommended` Config
The easiest way to use this plugin is to extend from the `recommended` config, like this:
```jsonc
{
"extends": [
"plugin:deprecation/recommended",
],
}
```
The `recommended` config will enable the plugin and enable the `deprecation/deprecation` rule with a value of `error`.
### Manually Enable the Plugin and Rule
If you don't want to use the `recommended` config for some reason, you can accomplish the same thing by specifying the following config:
```jsonc
{
"plugins": [
"deprecation",
],
"rules": {
"deprecation/deprecation": "error",
},
}
```
## Rules
### Disallow usage of deprecated APIs (`deprecation/deprecation`)
Reports usage of any code marked with a [`@deprecated` JSDoc tag](https://jsdoc.app/tags-deprecated.html).
For example, this includes browser APIs, Node.js APIs, library APIs and any other code that is marked with this tag.
#### Rule Details
Examples of **incorrect** code for this rule:
```ts
import { parse } from 'node:url';
import cheerio from 'cheerio';
// Node.js API
const url = parse('/foo'); // ❌ 'parse' is deprecated. Use the WHATWG URL API instead. eslint(deprecation/deprecation)
// Browser API
console.log(event?.bubbles); // ❌ 'event' is deprecated. [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/event) eslint(deprecation/deprecation)
// Deprecated library API
cheerio('
Hello world
'); // ❌ 'cheerio' is deprecated. Use the function returned by `load` instead. eslint(deprecation/deprecation)
```
Examples of **correct** code for this rule:
```ts
import { load } from 'cheerio';
import { ChangeEvent } from 'react';
// Node.js API
const url2 = new URL('/foo', 'http://www.example.com'); // ✅ Modern Node.js API, uses `new URL()`
// Browser API
function onClick(event: ChangeEvent) {
console.log(event.bubbles); // ✅ Modern browser API, does not use global
}
// Library API
load('
Hello world
'); // ✅ Allowed library API, uses named `load` import
```
## Credits
This rule was originally ported from the [SonarJS repository](https://github.com/SonarSource/SonarJS).