Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.defineProperties: wiele deskryptorów naraz

Object.defineProperties definiuje wiele właściwości z pełnymi deskryptorami, po wcześniejszym zebraniu i sprawdzeniu całej mapy deskryptorów.

Wersja: ECMAScript 5 onward; example target: Node.js 24.22.2

Składnia

Object.defineProperties(obj, properties)

Object.defineProperties(obj, properties) wymaga, aby obj był obiektem; nie opakowuje wartości pierwotnych. properties przechodzi przez ToObject, więc null i undefined powodują TypeError. Metoda robi migawkę własnych kluczy tekstowych i symbolicznych mapy, a następnie uwzględnia tylko te, których własny deskryptor jest wtedy wyliczalny.

Najpierw odczytuje każdą wybraną wartość i konwertuje ją przez ToPropertyDescriptor; dopiero po pomyślnym zebraniu wszystkich deskryptorów zaczyna definiować właściwości na celu. Dlatego błędny deskryptor lub wyjątek gettera w tej pierwszej fazie pozostawia cel bez zmian. Sama faza definiowania jest jednak sekwencyjna, a nie transakcyjna: jeśli późniejsza definicja jest niezgodna, wcześniejsze mogą już pozostać.

Metoda zwraca ten sam obj i istnieje od ECMAScript 5. Przy tworzeniu nowej właściwości pominięte writable, enumerable i configurable stają się false, a value, get i set — undefined; przy zmianie istniejącej właściwości pominięte pola pozostają bez zmian. Nie wolno łączyć value/writable z get/set, a getter lub setter musi być funkcją albo undefined. Gettery i pułapki Proxy w mapie oraz na celu mogą wykonywać kod i rzucać TypeError lub własne wyjątki.

Przykłady

const token = Symbol("token");
const target = {};
Object.defineProperties(target, {
  visible: { value: 3, enumerable: true },
  doubled: { get() { return this.visible * 2; }, enumerable: true },
  [token]: { value: "ok" }
});
console.log(Object.keys(target).join(","), target.doubled, target[token]);
console.log(Object.getOwnPropertyDescriptor(target, "visible").writable);
const untouched = {};
try {
  Object.defineProperties(untouched, {
    first: { value: 1 },
    bad: { get: 1 }
  });
} catch (error) { console.log(error.name, Object.hasOwn(untouched, "first")); }
const partial = {};
Object.defineProperty(partial, "locked", { value: 1 });
try {
  Object.defineProperties(partial, {
    added: { value: 2 },
    locked: { value: 3 }
  });
} catch (error) { console.log(error.name, partial.added, partial.locked); }

Wynik

visible,doubled 6 ok
false
TypeError false
TypeError 2 1

Przykład pokazuje symbole, restrykcyjne wartości domyślne, walidację przed zmianą i częściową zmianę w fazie definicji.

Źródła