Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Przypisanie z dodawaniem (+=)

Operator += wykonuje dodawanie liczb lub łączenie tekstów, a następnie próbuje zapisać wynik w celu przypisania, który oblicza tylko raz. Jeśli zapis nie zgłosi wyjątku, wartością wyrażenia jest obliczony wynik, nawet gdy zapis zostanie zignorowany.

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 += expression

target += expression odczytuje bieżącą wartość celu, oblicza prawy operand, stosuje reguły + i próbuje zapisać wynik w tym samym celu. Jeśli zapis nie zgłosi wyjątku, wartością całego wyrażenia jest obliczony wynik. Poza trybem ścisłym próba zapisu do właściwości, która nie zezwala na zapis, może zostać zignorowana bez zgłaszania wyjątku: właściwość pozostaje bez zmian, ale wyrażenie nadal ma wartość obliczonego wyniku. W trybie ścisłym taka próba zapisu zgłasza TypeError.

Dla zwykłej zmiennej przypomina target = target + expression, ale cel jest obliczany tylko raz. Ma to znaczenie przy właściwościach, indeksach i efektach ubocznych. Lewa strona musi być poprawnym celem przypisania; przypisanie do zmiennej const zgłasza TypeError.

Operandy są najpierw przekształcane do wartości prostych. Jeśli co najmniej jedna z tych wartości jest tekstem, operator próbuje połączyć operandy jako tekst. Połączenie tekstu z wartością typu Symbol zgłasza TypeError podczas niejawnej konwersji symbolu na tekst. Jeśli żadna z wartości nie jest tekstem, operator próbuje przekształcić obie wartości na potrzeby dodawania numerycznego. Konwersja wartości typu Symbol w tym przypadku zgłasza TypeError. Mieszanie Number i BigInt w dodawaniu numerycznym również zgłasza TypeError. Dlatego total += "3" może zmienić liczbę w tekst. Obiekty mogą uruchamiać własny kod podczas konwersji.

Przykłady

let total = 7;
const result = (total += 5);
console.log(total, result);

total += "3";
console.log(total, typeof total);

let count = 7n;
count += 5n;
console.log(String(count));

Wynik

12 12
123 string
12

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła