База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — дескриптори на собствени свойства

За обикновен обект Object.getOwnPropertyDescriptors връща дескрипторите на всички негови собствени свойства, включително неизброимите свойства и тези с ключове Symbol. С него могат да се проверяват атрибути или да се копират свойства, без аксесорите да се превръщат в стойности.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Object.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) връща нов обикновен обект. Методът получава от obj списъка с ключове на собствените му свойства и включва в резултата дескриптор за всеки ключ от списъка, за който obj съобщава такъв. Обхваща низови ключове и ключове от тип Symbol, включително ключовете на неизброими свойства; наследените свойства се изключват.

Дескрипторът на свойство с данни съдържа value, writable, enumerable и configurable. Дескрипторът на аксесорно свойство съдържа get и set вместо value и writable; липсваща функция се представя като undefined. Четенето на дескрипторите на обикновен обект не извиква неговите гетъри. При Proxy обаче могат да се задействат капани и да възникнат изключения. Резултатът може да е непълен и без да бъде хвърлено изключение: капанът ownKeys може да пропусне ключа на конфигурируемо собствено свойство на разширяем целеви обект, дори ако проксито продължава да съобщава дескриптор на собствено свойство за този ключ. Тогава методът не включва този дескриптор в резултата.

За обикновен обект шаблонът Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) създава плитко копие със същия прототип и атрибути на собствените свойства. За разлика от Object.assign, той запазва аксесорите и неизброимите свойства. Вложените обекти остават споделени; това не е общ метод за клониране на обекти, зависещи от вътрешни слотове, като Map.

null и undefined причиняват TypeError; останалите примитивни стойности се обвиват като обекти. Методът принадлежи към ECMAScript 2017, а не към Web APIs. Поддръжката в целевия браузър трябва да се провери отделно — наличието в Node 24 не я доказва.

Примери

let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
  hidden: { value: 7, enumerable: false },
  doubled: {
    get() { reads += 1; return this.hidden * 2; },
    enumerable: true
  }
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);

Резултат

0
7 false
function
14 1
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници