Subtraction (-)
The subtraction (-) operator subtracts the two operands, producing their
difference.
Try it
Syntax
x - y
Description
The subtraction operator converts both operands to numeric values and carries out either number subtraction or BigInt subtraction, depending on the two operands' types. If the types don't match, a TypeError is thrown.
Examples
Subtraction with numbers
// Number - Number -> subtraction
5 - 3; // 2
// Number - Number -> subtraction
3 - 5; // -2
Subtraction with non-numbers
// 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
Subtraction with BigInts
// 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
Specifications
| Specification |
|---|
| ECMAScript Language Specification # sec-subtraction-operator-minus |
Browser compatibility
BCD tables only load in the browser