Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje