CKTIS / JavaScript
Prirejanje z seštevanjem (+=)
Operator += sešteje števila ali združi nize, nato pa poskusi rezultat zapisati v cilj prirejanja, ki ga ovrednoti samo enkrat. Če poskus zapisa ne sproži izjeme, je vrednost izraza izračunani rezultat, tudi če se zapis prezre.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
target += expressiontarget += expression prebere trenutno vrednost cilja, ovrednoti desni operand, uporabi pravila operatorja + in poskusi rezultat zapisati v isti cilj. Če poskus zapisa ne sproži izjeme, je vrednost celotnega izraza izračunani rezultat. Zunaj strogega načina je lahko poskus zapisa v lastnost, ki ne dovoljuje pisanja, prezrt brez izjeme: lastnost ostane nespremenjena, vrednost izraza pa je kljub temu izračunani rezultat. V strogem načinu tak poskus zapisa sproži TypeError.
Pri preprosti spremenljivki je podoben zapisu target = target + expression, vendar se cilj ovrednoti samo enkrat. To je pomembno pri lastnostih, indeksih in stranskih učinkih. Leva stran mora biti veljaven cilj prirejanja; prirejanje v vezavo const sproži TypeError.
Operanda se najprej pretvorita v primitivni vrednosti. Če je vsaj ena od teh vrednosti niz, ju operator poskusi združiti kot niza. Če je druga vrednost tipa Symbol, njena implicitna pretvorba v niz sproži TypeError. Če nobena od vrednosti ni niz, ju operator poskusi pretvoriti za številsko seštevanje. Pretvorba vrednosti tipa Symbol v tem primeru sproži TypeError. Tudi mešanje Number in BigInt pri številskem seštevanju sproži TypeError. Zato lahko total += "3" število spremeni v niz. Objekti lahko med pretvorbo izvajajo lastno kodo.
Primeri
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));Rezultat
12 12 123 string 12
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.