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.