CKTIS / JavaScript
Reflect — explicitní operace s objekty
Reflect poskytuje statické metody pro čtení, zápis a prohlížení objektů. Logická návratová hodnota při zápisu umožňuje ověřit, zda se operace podařila, neznamená však, že metoda nikdy nemůže vyvolat výjimku.
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.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)Reflect je vestavěný objekt ECMAScriptu, nikoli funkce ani konstruktor: Reflect() a new Reflect() vyvolají TypeError. Jeho metody zpřístupňují operace odpovídající interním mechanismům objektů.
Reflect.get čte vlastnost, zatímco Reflect.set se ji pokusí zapsat a vrací logickou hodnotu, nikoli přiřazenou hodnotu. Volitelný parametr receiver má u obou metod výchozí hodnotu target a určuje hodnotu this při volání getterů nebo setterů. Reflect.ownKeys vrací všechny vlastní klíče typu řetězec i symbol, včetně neenumerovatelných; zděděné klíče vynechává.
Reflect.defineProperty vrací false, když objekt odmítne platný deskriptor, zatímco Object.defineProperty v takové situaci vyvolá výjimku. Logický výsledek nezaručuje, že k výjimkám nedojde: mohou je způsobit neplatné argumenty i kód getterů, setterů nebo pastí Proxy. Operace s vlastnostmi vyžadují, aby target byl objekt.
V příkladu vlastnost není enumerovatelná ani zapisovatelná. Reflect.set vrací false i ve striktním režimu, hodnota zůstává 10 a Reflect.ownKeys klíč stále najde.
Pří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ýsledek
10 false score 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.