CKTIS / JavaScript
Reflect — explicitné operácie s objektmi
Reflect poskytuje statické metódy na čítanie, zápis a skúmanie objektov. Logická návratová hodnota pri zápise umožňuje overiť, či bola operácia úspešná, neznamená však, že metóda nikdy nemôže vyvolať výnimku.
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.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)Reflect je vstavaný objekt ECMAScriptu, nie funkcia ani konštruktor: Reflect() a new Reflect() vyvolajú TypeError. Jeho metódy sprístupňujú operácie zodpovedajúce interným mechanizmom objektov.
Reflect.get číta vlastnosť, zatiaľ čo Reflect.set sa ju pokúsi zapísať a vracia logickú hodnotu, nie priradenú hodnotu. Voliteľný parameter receiver má pri oboch metódach predvolenú hodnotu target a určuje hodnotu this pri volaní getterov alebo setterov. Reflect.ownKeys vracia všetky vlastné kľúče typu reťazec aj symbol vrátane neenumerovateľných; zdedené kľúče vynecháva.
Reflect.defineProperty vracia false, keď objekt odmietne platný deskriptor, zatiaľ čo Object.defineProperty v takej situácii vyvolá výnimku. Logický výsledok nezaručuje, že nedôjde k výnimkám: môžu ich spôsobiť neplatné argumenty aj kód getterov, setterov alebo pascí Proxy. Operácie s vlastnosťami vyžadujú, aby target bol objekt.
V príklade vlastnosť nie je enumerovateľná ani zapisovateľná. Reflect.set vracia false aj v striktnom režime, hodnota zostáva 10 a Reflect.ownKeys kľúč stále nájde.
Príklady
"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
value: 10,
writable: false,
enumerable: false,
configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));Výsledok
10 false score 10
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.