CKTIS / JavaScript
Reflect.defineProperty — definiowanie właściwości z wynikiem logicznym
Reflect.defineProperty definiuje lub zmienia własną właściwość obiektu na podstawie deskryptora. Zwraca true albo false, ale nie gwarantuje braku wyjątków.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Reflect.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) definiuje lub zmienia własną właściwość obiektu target. Klucz jest konwertowany na string albo symbol, a attributes jest obiektem deskryptora. Metoda zwraca true, gdy operacja się powiedzie, lub false, gdy reguły obiektu ją odrzucą.
Deskryptor danych używa value i writable; deskryptor akcesorowy używa get i set. Oba mogą zawierać enumerable i configurable. Nie wolno łączyć pól danych z polami akcesorowymi. Przy tworzeniu właściwości w zwykłym obiekcie pominięte flagi mają domyślnie wartość false, a pominięta wartość danych to undefined. W zwykłym obiekcie przy zmianie istniejącej właściwości pominięte pola pozostają bez zmian, jeśli nie zmienia się rodzaj właściwości. Właściwość konfigurowalną można zmienić z właściwości danych na akcesorową lub odwrotnie, a pominięte enumerable i configurable zachowują wtedy dotychczasowe wartości. Na przykład przy zmianie konfigurowalnej właściwości danych na akcesorową przez podanie tylko get pola value i writable znikają, a pominięte set przyjmuje wartość undefined.
Pułapka defineProperty obiektu Proxy otrzymuje obiekt deskryptora, w którym pominiętych pól nadal nie ma. Może utworzyć właściwość w obiekcie opakowanym przez Proxy z innymi atrybutami, o ile nie narusza niezmienników Proxy.
W odróżnieniu od Object.defineProperty, które zwraca obiekt i rzuca TypeError przy odrzuceniu definicji, ta metoda zwraca wynik logiczny. Nie jest jednak bezwyjątkowa: target niebędący obiektem, nieprawidłowy deskryptor lub wyjątek podczas konwersji klucza mogą przerwać wywołanie. Pułapka defineProperty obiektu Proxy również może rzucić wyjątek.
Dla zwykłego obiektu dodanie właściwości do obiektu nierozszerzalnego lub niedozwolona zmiana właściwości niekonfigurowalnej daje false. W przykładzie druga definicja nie może zmienić id, ponieważ writable i configurable mają wartość false; wartość pozostaje równa 7.
Przykłady
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(","));Wynik
true false 7 id
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.