CKTIS / JavaScript
Subtraktionszuweisung (-=)
Der Operator -= zieht den rechten Operanden vom aktuellen Wert des linken Operanden ab und speichert das Ergebnis an derselben Stelle. Dabei erfolgt eine numerische Umwandlung; der gesamte Ausdruck gibt den zugewiesenen Wert zurück.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
target -= expressionDer Operator -= verbindet Subtraktion mit Zuweisung. Bei einer einfachen Variablen funktioniert x -= y wie x = x - y, doch der Ausdruck, der den linken Operanden bestimmt, wird nur einmal ausgewertet. Das ist wichtig, wenn auf eine Eigenschaft oder ein Array-Element mit Seiteneffekten zugegriffen wird.
Zuerst wird der Speicherort bestimmt und sein Wert gelesen; danach wird der rechte Operand ausgewertet. Auf die numerische Umwandlung folgen Subtraktion und Speicherung. Der Wert des gesamten Ausdrucks ist das Ergebnis der Subtraktion.
Nach der Umwandlung müssen beide Operanden entweder Werte vom Typ Number oder beide vom Typ BigInt sein; eine Mischung dieser Typen löst einen TypeError aus. Numerischer Text wie "12" kann in eine Number umgewandelt werden. Anders als += verkettet der Operator -= keine Zeichenfolgen.
Der linke Operand muss ein gültiges Zuweisungsziel sein. Der Versuch, eine mit const deklarierte Variable zu ändern, löst einen TypeError aus. Im Beispiel wird remaining zur Zahl 7, und result erhält denselben Wert.
Beispiele
let remaining = "12";
const result = (remaining -= 5);
console.log(remaining);
console.log(result);
console.log(typeof remaining);Ergebnis
7 7 number
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.