оператор-присваивание

Требовать или запрещать сокращенную запись оператора присваивания, где это возможно

JavaScript предоставляет сокращенные операторы, которые объединяют присваивание переменной и некоторые простые математические операции. Например, x = x + 4 можно сократить до x += 4. Поддерживаемые сокращенные формы следующие:

 Shorthand | Separate
-----------|------------
 x += y    | x = x + y
 x -= y    | x = x - y
 x *= y    | x = x * y
 x /= y    | x = x / y
 x %= y    | x = x % y
 x **= y   | x = x ** y
 x <<= y   | x = x << y
 x >>= y   | x = x >> y
 x >>>= y  | x = x >>> y
 x &= y    | x = x & y
 x ^= y    | x = x ^ y
 x |= y    | x = x | y

Подробное описание правила

Это правило требует или запрещает сокращенную запись оператора присваивания, где это возможно.

Правило применяется к операторам, перечисленным в вышеприведенной таблице. Оно не проверяет логические операторы присваивания &&=, ||=, и ??=, потому что их поведение короткого замыкания отличается от других операторов присваивания.

Параметры

Это правило имеет один строковый параметр:

• "always" (по умолчанию) требует сокращенную запись оператора присваивания, где это возможно
• "never" запрещает сокращенную запись оператора присваивания

always

Примеры неправильного кода для этого правила с параметром по умолчанию "always":

/*eslint operator-assignment: ["error", "always"]*/

x = x + y;
x = y * x;
x[0] = x[0] / y;
x.y = x.y << z;

Примеры правильного кода для этого правила с параметром по умолчанию "always":

/*eslint operator-assignment: ["error", "always"]*/

x = y;
x += y;
x = y * z;
x = (x * y) * z;
x[0] /= y;
x[foo()] = x[foo()] % 2;
x = y + x; // `+` is not always commutative (e.g. x = "abc")

never

Примеры неправильного кода для этого правила с параметром "never":

/*eslint operator-assignment: ["error", "never"]*/

x *= y;
x ^= (y + z) / foo();

Примеры правильного кода для этого правила с параметром "never":

/*eslint operator-assignment: ["error", "never"]*/

x = x + y;
x.y = x.y / a.b;

Когда не следует использовать это правило

Использование сокращенной записи оператора присваивания — это вопрос стиля. Отключение этого правила позволит разработчикам самостоятельно выбирать более удобочитаемый стиль в каждом конкретном случае.

Версия

Это правило было добавлено в ESLint v0.10.0.

Ресурсы

• Исходный код правила
• Исходный код тестов