Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.defineProperties: viac deskriptorov naraz

Object.defineProperties definuje viac vlastností úplnými deskriptormi po zhromaždení a overení celej mapy.

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

Syntax

Object.defineProperties(obj, properties)

Object.defineProperties(obj, properties) vyžaduje, aby obj bol objekt, a primitívne hodnoty nebaľuje. properties prejde ToObject, takže null a undefined vyvolajú TypeError. Metóda vytvorí snímku vlastných reťazcových a symbolových kľúčov mapy a zahrnie len tie, ktorých aktuálny vlastný deskriptor je vyčísliteľný.

Najprv načíta každú vybranú hodnotu a prevedie ju cez ToPropertyDescriptor; vlastnosti cieľa začne definovať až po úspešnom zhromaždení všetkých deskriptorov. Neplatný deskriptor alebo vyhadzujúci getter v prvej fáze preto nechá cieľ bez zmeny. Definovanie je však sekvenčné, nie transakčné: ak neskoršia definícia zlyhá, skoršie už môžu zostať.

Metóda vracia rovnaké obj a existuje od ECMAScript 5. Pri vytvorení novej vlastnosti sú vynechané writable, enumerable a configurable false a vynechané value, get a set undefined; pri zmene existujúcej vlastnosti zostávajú vynechané polia bez zmeny. value/writable nemožno kombinovať s get/set a accessor musí byť volateľný alebo undefined. Gettery a pasce Proxy mapy či cieľa môžu spúšťať kód a vyvolať výnimku.

Príklady

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

Výsledok

visible,doubled 6 ok
false
TypeError false
TypeError 2 1

Príklad ukazuje symboly, reštriktívne predvolené hodnoty, predbežné overenie a čiastočnú zmenu.

Zdroje