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

desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
Deno
Node.js
Subtraction assignment (x -= y)

See also