Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Subtraktion (-)

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Der Subtraktionsoperator (-) subtrahiert die beiden Operanden und liefert ihre Differenz.

Probieren Sie es aus

console.log(5 - 3);
// Expected output: 2

console.log(3.5 - 5);
// Expected output: -1.5

console.log(5 - "hello");
// Expected output: NaN

console.log(5 - true);
// Expected output: 4

Syntax

js
x - y

Beschreibung

Der Operator - ist für zwei Operandentypen überladen: Number und BigInt. Zuerst konvertiert er beide Operanden in numerische Werte und prüft deren Typen. Wenn beide Operanden zu BigInt-Werten werden, führt er eine BigInt-Subtraktion durch; andernfalls führt er eine Number-Subtraktion durch. Ein TypeError wird ausgelöst, wenn ein Operand zu einem BigInt-Wert und der andere zu einem Number-Wert wird.

Bei der Subtraktion von Number-Werten ist x - y als gleichwertig mit x + -y definiert. Daher gelten die Regeln der Addition:

  • Wenn einer der Operanden NaN ist, ist das Ergebnis NaN.
  • Infinity - Infinity ergibt NaN.
  • Wenn das mathematische Ergebnis 0 ist, wird 0 zurückgegeben – außer bei -0 - 0. In diesem Fall wird -0 zurückgegeben.

Beispiele

Subtraktion mit Number-Werten

js
5 - 3; // 2
3 - 5; // -2

Andere Werte, die keine BigInt-Werte sind, werden in Number-Werte konvertiert:

js
"foo" - 3; // NaN; "foo" is converted to the number NaN
5 - "3"; // 2; "3" is converted to the number 3

Subtraktion mit BigInt-Werten

js
2n - 1n; // 1n

Bei der Subtraktion können Sie BigInt- und Number-Operanden nicht kombinieren.

js
2n - 1; // TypeError: Cannot mix BigInt and other types, use explicit conversions
2 - 1n; // TypeError: Cannot mix BigInt and other types, use explicit conversions

Um einen BigInt-Wert und einen Wert, der kein BigInt-Wert ist, zu subtrahieren, konvertieren Sie einen der Operanden:

js
2n - BigInt(1); // 1n
Number(2n) - 1; // 1

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-subtraction-operator-minus

Browser-Kompatibilität

Siehe auch