CKTIS / JavaScript
Przypisanie z odejmowaniem (-=)
Operator -= odejmuje prawy operand od bieżącej wartości lewego operandu i zapisuje wynik w tym samym miejscu. Wykonuje konwersję numeryczną, a całe wyrażenie zwraca przypisaną wartość.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
target -= expressionOperator -= łączy odejmowanie z przypisaniem. Dla zwykłej zmiennej x -= y działa jak x = x - y, ale wyrażenie wskazujące lewy operand jest obliczane tylko raz. Ma to znaczenie przy dostępie do właściwości lub elementu tablicy z efektami ubocznymi.
Najpierw ustalane jest miejsce zapisu i odczytywana jego wartość, następnie obliczany jest prawy operand. Po konwersji numerycznej następują odejmowanie i zapis. Wartością całego wyrażenia jest wynik odejmowania.
Operandy po konwersji muszą być oba typu Number albo oba typu BigInt; mieszanie tych typów powoduje TypeError. Tekst liczbowy, taki jak "12", może zostać zamieniony na Number. W przeciwieństwie do += operator -= nie łączy tekstów.
Lewy operand musi być poprawnym celem przypisania. Próba zmiany zmiennej zadeklarowanej przez const powoduje TypeError. W przykładzie remaining staje się liczbą 7, a result otrzymuje tę samą wartość.
Przykłady
let remaining = "12";
const result = (remaining -= 5);
console.log(remaining);
console.log(result);
console.log(typeof remaining);Wynik
7 7 number
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.