Skip to content
Browse files

Docs: update status of breaking changes in migration guide (#11652)

This updates the migration guide to remove the "unimplemented" notice for features that have now been implemented, and it brings the `eslint:recommended` section up to date with the latest decision.
  • Loading branch information...
not-an-aardvark committed Apr 26, 2019
1 parent eef71e4 commit adc6585ce074e03fc8a842e8ebc5b082a0ed0b65
Showing with 1 addition and 8 deletions.
  1. +1 −8 docs/user-guide/
@@ -46,14 +46,11 @@ As of April 2018, Node.js 6 will be at EOL and will no longer be receiving secur

## <a name="eslint-recommended-changes"/> `eslint:recommended` has been updated

**Note:** This update is planned, but has not been implemented in the latest alpha release yet.

The following rules have been added to the [`eslint:recommended`]( config:

<!-- FIXME: this list is not final yet, see -->

* [`no-async-promise-executor`]( disallows using an `async` function as the argument to the `Promise` constructor, which is usually a bug.
* [`no-misleading-character-class`]( reports character classes in regular expressions that might not behave as expected.
* [`no-prototype-builtins`]( reports method calls like `foo.hasOwnProperty("bar")` (which are a frequent source of bugs), and suggests that they be replaced with `, "bar")` instead.
* [`no-shadow-restricted-names`]( disallows shadowing variables like `undefined` (e.g. with code like `let undefined = 5;`), since is likely to confuse readers.
* [`no-useless-catch`]( reports `catch` clauses that are redundant and can be removed from the code without changing its behavior.
* [`no-with`]( disallows use of the [`with` statement](, which can make code difficult to understand and cause compatibility problems.
@@ -115,8 +112,6 @@ As a rule of thumb: With ESLint v6, plugins should always be installed locally,

## <a name="no-redeclare-updates"></a> The `no-redeclare` rule is now more strict by default

**Note:** This update is planned, but has not been implemented in the latest alpha release yet.

The default options for the [`no-redeclare`]( rule have changed from `{ builtinGlobals: false }` to `{ builtinGlobals: true }`. Additionally, the `no-redeclare` rule will now report an error for globals enabled by comments like `/* global foo */` if those globals were already enabled through configuration anyway.

**To address:**
@@ -292,8 +287,6 @@ In some cases, rule schemas can use the `default` keyword to automatically speci

## <a name="eslintExplicitGlobalComment"></a> The `eslintExplicitGlobalComment` scope analysis property has been removed

**Note:** This update is planned, but has not been implemented in the latest alpha release yet.

Previously, ESLint would add an `eslintExplicitGlobalComment` property to `Variable` objects in scope analysis to indicate that a variable was introduced as a result of a `/* global */` comment. This property was undocumented, and the ESLint team was unable to find any usage of the property outside of ESLint core. The property has been removed in ESLint v6, and replaced with the `eslintExplicitGlobalComments` property, which can contain a list of all `/* global */` comments if a variable was declared with more than one of them.

**To address:** If you maintain a rule that uses the `eslintExplicitGlobalComment` property, update it to use the `eslintExplicitGlobalComments` property as a list instead.

0 comments on commit adc6585

Please sign in to comment.
You can’t perform that action at this time.