Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Reflect.set — priradenie vlastnosti s boolovským výsledkom

Reflect.set vykoná operáciu priradenia vlastnosti a vráti boolovskú hodnotu, ktorá vyjadruje, či bola úspešná. Voliteľný receiver umožňuje oddeliť objekt, na ktorom sa vyhľadávanie vlastnosti začína, od objektu, do ktorého sa zapisuje.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

Reflect.set(target, key, value[, receiver]) vyvolá internú operáciu [[Set]] objektu target. Argument key sa prevedie na kľúč vlastnosti: reťazec alebo symbol. Ak sa receiver vynechá, jeho predvolenou hodnotou je target.

Výsledkom je true alebo false, nie priradená hodnota. Pri bežných objektoch môže false znamenať napríklad pokus zmeniť vlastnosť s writable: false, použiť prístupovú vlastnosť bez settera alebo pridať vlastnosť nerozšíriteľnému príjemcovi. Samotný výsledok false nespôsobí výnimku ani v prísnom režime, na rozdiel od odmietnutého priradenia target[key] = value v tomto režime.

Vyhľadávanie deskriptora sa začína na target a môže pokračovať cez jeho prototypy. Pri zapisovateľnej dátovej vlastnosti zápis zvyčajne vytvorí alebo aktualizuje vlastnú vlastnosť objektu receiver s ohľadom na jeho obmedzenia. Pri volaní settera sa receiver odovzdá ako argument this. Ak je setter bežnou funkciou JavaScriptu mimo prísneho režimu, namiesto null alebo undefined sa použije globálna hodnota this a ostatné primitívne hodnoty sa zabalia do objektov. Návratová hodnota settera sa ignoruje. true teda nezaručuje, že neskoršie čítanie vráti value.

Metóda neslúži na zachytávanie chýb: target, ktorý nie je objektom, spôsobí TypeError a výnimky pri prevode kľúča, zo settera alebo z pasce Proxy sa šíria ďalej. Pri priamom definovaní vlastnej vlastnosti sa neprehľadáva reťazec prototypov ani sa nevolajú zdedené settery. Naďalej však platia obmedzenia deskriptora existujúcej vlastnej vlastnosti. Nedá sa tak napríklad zmeniť hodnota vlastnej dátovej vlastnosti, ktorá je nekonfigurovateľná a zároveň nezapisovateľná.

Prí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ýsledok

true
1 7
false
10

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje