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.