Subtraction assignment (-=)
The subtraction assignment (-=) operator performs subtraction on the two operands and assigns the result to the left operand.
Try it
Syntax
js
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
| Specification |
|---|
| ECMAScript Language Specification # sec-assignment-operators |
Browser compatibility
| desktop | mobile | server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Subtraction assignment ( x -= y) | |||||||||||||