CKTIS / JavaScript
PropertyDescriptor.value — vrednost podatkovne lastnosti
Polje `value` vsebuje shranjeno vrednost podatkovne lastnosti. Če ga v vhodnem opisniku izpustiš, to ni isto, kot če izrecno navedeš `value: undefined`.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
Object.defineProperty(target, key, { value: newValue })
const descriptor = Object.getOwnPropertyDescriptor(target, key);
if (descriptor !== undefined && Object.hasOwn(descriptor, "value")) {
const storedValue = descriptor.value;
}PropertyDescriptor.value označuje polje value objekta, ki opisuje podatkovno lastnost, ne pa lastnosti globalnega konstruktorja. Ustreza polju [[Value]] v specifikaciji in lahko vsebuje katero koli vrednost JavaScript, tudi objekt, funkcijo ali undefined. writable določa, ali lahko s prireditvijo nadomestiš vrednost; shranjenega objekta ne zamrzne.
Pri običajnem objektu Object.defineProperty() uporabi privzeto vrednost undefined, če ustvari podatkovno lastnost brez polja value. Če spremeniš obstoječo podatkovno lastnost, ne da bi spremenil njeno vrsto, izpuščeno polje value ohrani prejšnjo vrednost, value: undefined pa zahteva njeno zamenjavo. Če obstoječa podatkovna lastnost ni nastavljiva niti zapisljiva, drugačna vrednost po SameValue (primerjavi, ki jo uporablja Object.is) sproži TypeError.
Dostopovni opisnik uporablja get in set namesto value in writable. V vhodnem opisniku ne smeš mešati polj iz obeh skupin: tudi { value: undefined, get: undefined } sproži TypeError. Upoštevajo se tudi podedovana polja vhodnega opisnika.
Object.getOwnPropertyDescriptor() vrne undefined, če za dani ključ ni lastne lastnosti. Če vrne opisnik, Object.hasOwn(descriptor, "value") loči podatkovno lastnost z vrednostjo undefined od dostopovne lastnosti. Opisnik ne odraža sprotnih sprememb lastnosti: sprememba descriptor.value ne nadomesti vrednosti na ciljnem objektu. Če je shranjena vrednost objekt, se opisnik sklicuje na isti objekt, ne na njegovo kopijo.
Primeri
{
const target = { score: 7, get label() { return "ready"; } };
const before = Object.getOwnPropertyDescriptor(target, "score");
Object.defineProperty(target, "score", { enumerable: false });
console.log(String(target.score));
Object.defineProperty(target, "score", { value: undefined });
const data = Object.getOwnPropertyDescriptor(target, "score");
const accessor = Object.getOwnPropertyDescriptor(target, "label");
console.log(`${Object.hasOwn(data, "value")}: ${data.value}`);
console.log(`${Object.hasOwn(accessor, "value")}: ${target.label}`);
console.log(String(before.value));
}Rezultat
7 true: undefined false: ready 7
Če izpustiš `value`, se `7` ohrani; izrecni `value: undefined` jo nadomesti. Opisnik lastnosti `label` nima lastnega polja `value`, čeprav branje `target.label` pokliče getter in vrne `ready`. Prej pridobljeni opisnik `before` še vedno vsebuje `7`.
Povezane lekcije
- JavaScript · Lekcija 45 · Napredna · Različica: 4