Subtraction assignment (-=)

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

The **subtraction assignment (-=)** operator performs subtraction on the two operands and assigns the result to the left operand.

{{InteractiveExample("JavaScript Demo: Subtraction assignment (-=) operator")}}

js interactive-example
let a = 2;

console.log((a -= 3));
// Expected output: -1

console.log((a -= "Hello"));
// Expected output: NaN

Syntax

js-nolint
x -= y

Description

x -= y is equivalent to x = x - y, except that the expression x is only evaluated once.

Examples

Subtraction assignment using numbers

js
let bar = 5;

bar -= 2; // 3

Other non-BigInt values are coerced to numbers:

js
bar -= "foo"; // NaN

Subtraction assignment using BigInts

js
let foo = 3n;
foo -= 2n; // 1n
foo -= 1; // TypeError: Cannot mix BigInt and other types, use explicit conversions

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also