CKTIS / JavaScript
Присвояване със събиране (+=)
Операторът += събира числа или свързва низове, след което се опитва да запише резултата в целта на присвояването, която изчислява само веднъж. Ако записът не предизвика изключение, стойността на израза е изчисленият резултат, дори записът да бъде пренебрегнат.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
target += expressiontarget += expression прочита текущата стойност на целта, изчислява десния операнд, прилага правилата на + и се опитва да запише резултата в същата цел. Ако записът не предизвика изключение, стойността на целия израз е изчисленият резултат. Извън строг режим опитът за запис в свойство, което не допуска запис, може да бъде пренебрегнат без изключение: свойството остава непроменено, но стойността на израза все пак е изчисленият резултат. В строг режим такъв опит за запис предизвиква TypeError.
При обикновена променлива това прилича на target = target + expression, но целта се изчислява само веднъж. Това е важно при свойства, индекси и странични ефекти. Лявата страна трябва да е валидна цел за присвояване; присвояването на обвързване const предизвиква TypeError.
Операндите първо се преобразуват до примитивни стойности. Ако поне една от тези стойности е низ, операторът се опитва да ги свърже като низове. Ако другата стойност е от тип Symbol, неявното ѝ преобразуване в низ предизвиква TypeError. Ако нито една от стойностите не е низ, операторът се опитва да преобразува и двете за числово събиране. В този случай преобразуването на стойност от тип Symbol предизвиква TypeError. Смесването на Number и BigInt при числово събиране също предизвиква TypeError. Затова total += "3" може да превърне число в низ. Обектите могат да изпълняват собствен код по време на преобразуването.
Примери
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));Резултат
12 12 123 string 12
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.