Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

target += 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.

Zdroje