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: NaNSyntax
js-nolint
x -= yDescription
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; // 3Other non-BigInt values are coerced to numbers:
js
bar -= "foo"; // NaNSubtraction assignment using BigInts
js
let foo = 3n;
foo -= 2n; // 1n
foo -= 1; // TypeError: Cannot mix BigInt and other types, use explicit conversionsSpecifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Assignment operators in the JS guide
- [Subtraction (
-)](/en-US/docs/Web/JavaScript/Reference/Operators/Subtraction)