The - operator subtracts the two operands, producing their difference.
The - operator subtracts the two operands, producing their difference.
x - y
The - operator is overloaded for two types of operands: number and BigInt. It first coerces both operands to numeric values and tests the types of them. It performs BigInt subtraction if both operands become BigInts; otherwise, it performs number subtraction. A TypeError is thrown if one operand becomes a BigInt but the other becomes a number.
// Number - Number -> subtraction 5 - 3; // 2 // Number - Number -> subtraction 3 - 5; // -2
// String - Number -> subtraction "foo" - 3; // NaN; "foo" is converted to the number NaN // Number - String -> subtraction 5 - "3"; // 2; "3" is converted to the number 3
// BigInt - BigInt -> subtraction 2n - 1n; // 1n
You cannot mix BigInt and number operands in subtraction.
2n - 1; // TypeError: Cannot mix BigInt and other types, use explicit conversions 2 - 1n; // TypeError: Cannot mix BigInt and other types, use explicit conversions
| Desktop | Mobile | Server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
Subtraction |
1 | 12 | 1 | 3 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1.0 | 0.10.0 | |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Subtraction