Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Object.defineProperties: više deskriptora odjednom

Object.defineProperties definira više svojstava potpunim deskriptorima nakon prikupljanja i provjere cijele mape.

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

Sintaksa

Object.defineProperties(obj, properties)

Object.defineProperties(obj, properties) zahtijeva da obj bude objekt i ne omata primitivne vrijednosti. properties prolazi kroz ToObject, pa null i undefined bacaju TypeError. Metoda snima vlastite tekstualne i simbolske ključeve mape te uključuje samo one čiji je trenutačni vlastiti deskriptor nabrojiv.

Najprije dohvaća svaku odabranu vrijednost i pretvara je s ToPropertyDescriptor; svojstva na cilju počinje definirati tek nakon uspješnog prikupljanja svih deskriptora. Nevaljan deskriptor ili getter koji baci u prvoj fazi zato ostavlja cilj nepromijenjenim. Definiranje je ipak sekvencijalno, a ne transakcijsko: ako kasnija definicija ne uspije, ranije mogu ostati.

Metoda vraća isti obj i postoji od ECMAScript 5. Pri stvaranju novog svojstva izostavljeni writable, enumerable i configurable postaju false, a izostavljeni value, get i set undefined; pri promjeni postojećeg svojstva izostavljena polja ostaju nepromijenjena. value/writable ne smiju se miješati s get/set, a accessor mora biti pozivljiv ili undefined. Getteri i Proxy zamke na mapi ili cilju mogu izvršavati kod i bacati iznimke.

Primjeri

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); }

Rezultat

visible,doubled 6 ok
false
TypeError false
TypeError 2 1

Primjer pokazuje simbole, restriktivne zadane vrijednosti, prethodnu provjeru i djelomičnu promjenu.

Izvori