Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Reflect.getOwnPropertyDescriptor — prozkoumání vlastní vlastnosti

Reflect.getOwnPropertyDescriptor(target, key) vrací deskriptor vlastní vlastnosti, nebo undefined. Umožňuje prohlédnout hodnotu, přístupové funkce a atributy vlastnosti, aniž by prohledával řetězec prototypů.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

Reflect.getOwnPropertyDescriptor(target, key)

Reflect.getOwnPropertyDescriptor(target, key) popisuje pouze vlastní vlastnost objektu target, včetně vlastnosti, která není vyčíslitelná. Vrací nový objekt deskriptoru, nebo undefined, pokud vlastnost není vlastní. Zděděná vlastnost se v řetězci prototypů nehledá; vlastní vlastnost s hodnotou undefined má přesto svůj deskriptor.

Datový deskriptor obsahuje value, writable, enumerable a configurable. Deskriptor přístupové vlastnosti obsahuje místo value a writable položky get a set; jejich hodnotami jsou funkce nebo undefined. Prohlížení deskriptoru běžného objektu nevyvolá jeho getter. Úprava vráceného deskriptoru sama o sobě vlastnost nedefinuje znovu; k tomu lze použít například Object.defineProperty.

target musí být objekt; každá primitivní hodnota včetně null a undefined způsobí TypeError. To se liší od Object.getOwnPropertyDescriptor, který obaluje primitivní hodnoty kromě null a undefined. Operace ToPropertyKey převádí key na klíč vlastnosti. Pokud je key objekt, operace jej nejprve převede na primitivní hodnotu, například voláním jeho metody Symbol.toPrimitive. Pokud je primitivní hodnotou symbol, použije se jako klíč beze změny; jinak se hodnota převede na řetězec.

Nepředpokládejte, že operace nikdy nemá vedlejší účinky: převod key může spustit uživatelský kód a objekt Proxy může vyvolat svou past getOwnPropertyDescriptor. Výsledné výjimky se předávají volajícímu. Příklad ukazuje, že zděděná vlastnost je ignorována a že změna descriptor.value nezmění item.score.

Příklady

const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
  value: 42,
  writable: false,
  enumerable: true,
  configurable: true
});

const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);

Výsledek

{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje