CKTIS / JavaScript
Reflect.set — dodjela svojstva s logičkim rezultatom
Reflect.set izvršava operaciju dodjele svojstva i vraća logičku vrijednost koja označava uspjeh. Neobavezni receiver omogućuje razdvajanje objekta na kojem počinje traženje svojstva od objekta u koji se zapisuje.
Verzija: 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]) poziva internu operaciju [[Set]] objekta target. Argument key pretvara se u ključ svojstva: niz ili simbol. Ako se receiver izostavi, zadana mu je vrijednost target.
Rezultat je true ili false, a ne dodijeljena vrijednost. Kod običnih objekata false može označavati, primjerice, pokušaj promjene svojstva s writable: false, uporabe pristupnog svojstva bez settera ili dodavanja svojstva neproširivom primatelju. Sam rezultat false ne uzrokuje iznimku čak ni u strogom načinu rada, za razliku od odbijene dodjele target[key] = value u tom načinu.
Traženje deskriptora počinje na objektu target i može prolaziti njegovim prototipima. Kod zapisivog podatkovnog svojstva zapis obično stvara ili ažurira vlastito svojstvo objekta receiver, uz uvažavanje njegovih ograničenja. Pri pozivu settera receiver se prosljeđuje kao argument this. Ako je setter obična JavaScript funkcija izvan strogog načina rada, umjesto null ili undefined upotrebljava se globalna vrijednost this, a ostale primitivne vrijednosti omataju se u objekte. Povratna vrijednost settera zanemaruje se. Zato true ne jamči da će naknadno čitanje vratiti value.
Metoda nije mehanizam za hvatanje pogrešaka: target koji nije objekt uzrokuje TypeError, a iznimke pri pretvorbi ključa, iz settera ili iz zamke Proxy prosljeđuju se dalje. Pri izravnom definiranju vlastitog svojstva ne pretražuje se lanac prototipova niti se pozivaju naslijeđeni setteri. Ograničenja deskriptora postojećeg vlastitog svojstva i dalje vrijede. Primjerice, nije moguće promijeniti vrijednost vlastitog podatkovnog svojstva koje nije ni konfigurabilno ni zapisivo.
Primjeri
"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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.