CKTIS / JavaScript
Object.defineProperties: več deskriptorjev hkrati
Object.defineProperties določi več lastnosti s polnimi deskriptorji, potem ko zbere in preveri celoten zemljevid.
Različica: ECMAScript 5 onward; example target: Node.js 24.22.2
Sintaksa
Object.defineProperties(obj, properties)Object.defineProperties(obj, properties) zahteva, da je obj objekt, in primitivnih vrednosti ne ovija. properties gre skozi ToObject, zato null in undefined sprožita TypeError. Metoda zajame lastne nizovne in simbolne ključe zemljevida ter vključi le tiste, katerih trenutni lastni deskriptor je našteven.
Najprej pridobi vsako izbrano vrednost in jo pretvori z ToPropertyDescriptor; lastnosti na cilju začne določati šele po uspešnem zbiranju vseh deskriptorjev. Neveljaven deskriptor ali getter, ki sproži izjemo v prvi fazi, zato cilj pusti nespremenjen. Določanje pa je zaporedno, ne transakcijsko: ob poznejšem neuspehu lahko prejšnje definicije ostanejo.
Metoda vrne isti obj in obstaja od ECMAScript 5. Pri ustvarjanju nove lastnosti izpuščeni writable, enumerable in configurable postanejo false, izpuščeni value, get in set pa undefined; pri spreminjanju obstoječe lastnosti izpuščena polja ostanejo nespremenjena. value/writable ni dovoljeno mešati z get/set, accessor pa mora biti klicljiv ali undefined. Getterji in pasti Proxy na zemljevidu ali cilju lahko izvajajo kodo in sprožijo izjeme.
Primeri
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
Primer pokaže simbole, omejevalne privzete vrednosti, predhodno preverjanje in delno spremembo.