CKTIS / JavaScript
Object.defineProperties: více deskriptorů najednou
Object.defineProperties definuje více vlastností úplnými deskriptory po shromáždění a ověření celé mapy.
Verze: ECMAScript 5 onward; example target: Node.js 24.22.2
Syntaxe
Object.defineProperties(obj, properties)Object.defineProperties(obj, properties) vyžaduje, aby obj byl objekt, a primitivní hodnoty nebalí. properties projde ToObject, takže null a undefined vyvolají TypeError. Metoda pořídí snímek vlastních řetězcových a symbolových klíčů mapy a zahrne jen ty, jejichž aktuální vlastní deskriptor je vyčíslitelný.
Nejprve načte každou vybranou hodnotu a převede ji přes ToPropertyDescriptor; vlastnosti cíle začne definovat až po úspěšném shromáždění všech deskriptorů. Neplatný deskriptor nebo vyhazující getter v první fázi proto nechá cíl beze změny. Definování je však sekvenční, nikoli transakční: selže-li pozdější definice, dřívější už mohou zůstat.
Metoda vrací stejné obj a existuje od ECMAScript 5. Při vytvoření nové vlastnosti jsou vynechané writable, enumerable a configurable false a vynechané value, get a set undefined; při změně existující vlastnosti zůstávají vynechaná pole beze změny. value/writable nelze kombinovat s get/set a accessor musí být volatelný nebo undefined. Gettery a pasti Proxy mapy či cíle mohou spouštět kód a vyvolat výjimku.
Pří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ýsledek
visible,doubled 6 ok false TypeError false TypeError 2 1
Příklad ukazuje symboly, restriktivní výchozí hodnoty, předběžné ověření a částečnou změnu.