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

CKTIS / JavaScript

Reflect.set — přiřazení vlastnosti s booleovským výsledkem

Reflect.set provede operaci přiřazení vlastnosti a vrátí booleovskou hodnotu, která vyjadřuje, zda byla úspěšná. Volitelný receiver umožňuje oddělit objekt, u kterého hledání vlastnosti začíná, od objektu, do kterého se zapisuje.

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

Reflect.set(target, key, value[, receiver])

Reflect.set(target, key, value[, receiver]) vyvolá interní operaci [[Set]] objektu target. Argument key se převede na klíč vlastnosti: řetězec nebo symbol. Pokud je receiver vynechán, jeho výchozí hodnotou je target.

Výsledkem je true nebo false, nikoli přiřazená hodnota. U běžných objektů může false znamenat například pokus o změnu vlastnosti s writable: false, použití přístupové vlastnosti bez setteru nebo přidání vlastnosti k nerozšiřitelnému příjemci. Samotný výsledek false nezpůsobí výjimku ani v přísném režimu, na rozdíl od odmítnutého přiřazení target[key] = value v tomto režimu.

Hledání deskriptoru začíná u target a může pokračovat přes jeho prototypy. U zapisovatelné datové vlastnosti zápis obvykle vytvoří nebo aktualizuje vlastní vlastnost objektu receiver s ohledem na jeho omezení. Při volání setteru se receiver předává jako argument this. Je-li setter běžná funkce JavaScriptu mimo přísný režim, místo null nebo undefined se použije globální hodnota this a ostatní primitivní hodnoty se zabalí do objektů. Návratová hodnota setteru se ignoruje. true tedy nezaručuje, že pozdější čtení vrátí value.

Metoda neslouží k zachytávání chyb: target, který není objektem, způsobí TypeError a výjimky při převodu klíče, ze setteru nebo z pasti Proxy se předávají dál. Při přímém definování vlastní vlastnosti se neprohledává řetězec prototypů ani se nevolají zděděné settery. Omezení deskriptoru existující vlastní vlastnosti však platí i nadále. Nelze tak například změnit hodnotu vlastní datové vlastnosti, která je nekonfigurovatelná a zároveň nezapisovatelná.

Příklady

"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);

Object.defineProperty(target, "fixed", {
  value: 10,
  writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);

Výsledek

true
1 7
false
10

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