CKTIS / JavaScript
Přiřazení se sčítáním (+=)
Operátor += sečte čísla nebo spojí řetězce a poté se pokusí výsledek zapsat do cíle přiřazení, který vyhodnotí pouze jednou. Pokud zápis nevyvolá výjimku, hodnotou výrazu je vypočtený výsledek, i když se zápis ignoruje.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
target += expressiontarget += expression přečte aktuální hodnotu cíle, vyhodnotí pravý operand, použije pravidla operátoru + a pokusí se výsledek zapsat do téhož cíle. Pokud zápis nevyvolá výjimku, hodnotou celého výrazu je vypočtený výsledek. Mimo striktní režim může být pokus o zápis do vlastnosti, která zápis neumožňuje, ignorován bez vyvolání výjimky: vlastnost zůstane beze změny, ale výraz přesto nabude hodnoty vypočteného výsledku. Ve striktním režimu takový pokus o zápis vyvolá TypeError.
U jednoduché proměnné se podobá zápisu target = target + expression, cíl se však vyhodnotí pouze jednou. To je důležité u vlastností, indexů a vedlejších účinků. Levá strana musí být platným cílem přiřazení; přiřazení do vazby const vyvolá TypeError.
Operandy se nejprve převedou na primitivní hodnoty. Pokud je alespoň jedna z těchto hodnot řetězec, operátor se je pokusí spojit jako řetězce. Je-li druhá hodnota typu Symbol, její implicitní převod na řetězec vyvolá TypeError. Pokud ani jedna z hodnot není řetězec, operátor se pokusí obě hodnoty převést pro číselné sčítání. Převod hodnoty typu Symbol v takovém případě vyvolá TypeError. Kombinace Number a BigInt při číselném sčítání také vyvolá TypeError. Výraz total += "3" proto může změnit číslo na řetězec. Objekty mohou během převodu spouštět vlastní kód.
Příklady
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));Výsledek
12 12 123 string 12
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.