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

CKTIS / JavaScript

Reflect.defineProperty — definování vlastností s logickým výsledkem

Reflect.defineProperty definuje nebo mění vlastní vlastnost objektu pomocí deskriptoru. Vrací true nebo false, ale nezaručuje provedení bez výjimek.

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.defineProperty(target, propertyKey, attributes)

Reflect.defineProperty(target, propertyKey, attributes) definuje nebo mění vlastní vlastnost objektu target. Klíč se převede na řetězec nebo symbol a attributes je objekt deskriptoru. Metoda vrací true, pokud se operace podaří, nebo false, pokud ji pravidla objektu odmítnou.

Datový deskriptor používá value a writable; přístupový deskriptor používá get a set. Oba mohou obsahovat enumerable a configurable. Datová pole se nesmějí kombinovat s přístupovými poli. Při vytváření vlastnosti na běžném objektu mají vynechané příznaky výchozí hodnotu false a vynechaná datová hodnota má výchozí hodnotu undefined. U běžného objektu zůstávají vynechaná pole beze změny, pokud se při úpravě existující vlastnosti nemění její druh. Konfigurovatelnou vlastnost lze změnit z datové na přístupovou nebo naopak. Pokud se při této změně vynechají enumerable a configurable, zachovají si dosavadní hodnoty. Pokud například změníte konfigurovatelnou datovou vlastnost na přístupovou zadáním pouze get, pole value a writable se odstraní a vynechané pole set se nastaví na undefined.

Past defineProperty objektu Proxy dostane objekt deskriptoru, v němž vynechaná pole nadále chybějí. Na cílovém objektu Proxy může vytvořit vlastnost s jinými atributy, pokud neporuší invarianty Proxy.

Na rozdíl od Object.defineProperty, která vrací objekt a při odmítnutí definice vyvolá TypeError, tato metoda vrací logický výsledek. Není však bez výjimek: volání může přerušit target, který není objektem, neplatný deskriptor nebo výjimka při převodu klíče. Výjimku může vyvolat také past defineProperty objektu Proxy.

U běžného objektu vrátí přidání vlastnosti do nerozšiřitelného objektu nebo nepovolená změna nekonfigurovatelné vlastnosti false. V příkladu nemůže druhá definice změnit id, protože writable a configurable mají hodnotu false; hodnota zůstane 7.

Příklady

const item = {};

console.log(Reflect.defineProperty(item, "id", {
  value: 7,
  enumerable: true,
  writable: false,
  configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));

Výsledek

true
false
7
id

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