CKTIS / JavaScript
Reflect.set — prirejanje lastnosti z logičnim rezultatom
Reflect.set izvede operacijo prirejanja lastnosti in vrne logično vrednost, ki pove, ali je bila uspešna. Izbirni receiver omogoča ločiti objekt, pri katerem se začne iskanje lastnosti, od objekta, v katerega se zapisuje.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Reflect.set(target, key, value[, receiver])Reflect.set(target, key, value[, receiver]) prikliče notranjo operacijo [[Set]] objekta target. Argument key se pretvori v ključ lastnosti: niz ali simbol. Če je receiver izpuščen, je njegova privzeta vrednost target.
Rezultat je true ali false, ne pa prirejena vrednost. Pri običajnih objektih lahko false na primer pomeni poskus spremembe lastnosti z writable: false, uporabe dostopne lastnosti brez setterja ali dodajanja lastnosti nerazširljivemu prejemniku. Sam rezultat false ne povzroči izjeme niti v strogem načinu, drugače kot zavrnjeno prirejanje target[key] = value v tem načinu.
Iskanje deskriptorja se začne pri target in lahko poteka po njegovih prototipih. Pri zapisljivi podatkovni lastnosti zapis običajno ustvari ali posodobi lastno lastnost objekta receiver ob upoštevanju njegovih omejitev. Ob klicu setterja se receiver posreduje kot argument this. Če je setter običajna funkcija JavaScript zunaj strogega načina, se namesto null ali undefined uporabi globalna vrednost this, druge primitivne vrednosti pa se ovijejo v objekte. Vrnjena vrednost setterja se prezre. Zato true ne zagotavlja, da bo poznejše branje vrnilo value.
Metoda ni namenjena prestrezanju napak: target, ki ni objekt, povzroči TypeError, izjeme pri pretvorbi ključa, iz setterja ali iz pasti Proxy pa se posredujejo naprej. Pri neposredni opredelitvi lastne lastnosti se veriga prototipov ne preišče in podedovani setterji se ne kličejo. Omejitve deskriptorja obstoječe lastne lastnosti pa še vedno veljajo. Tako na primer ni mogoče spremeniti vrednosti lastne podatkovne lastnosti, ki ni niti nastavljiva niti zapisljiva.
Primeri
"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);Rezultat
true 1 7 false 10
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.