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

CKTIS / JavaScript

Reflect.isExtensible — проверка дали обектът може да се разширява

Reflect.isExtensible(target) проверява дали даден обект може да се разширява. При обикновен обект това означава, че към него могат да се добавят нови собствени свойства. Методът връща булева стойност и хвърля TypeError при примитивни стойности.

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

Синтаксис

Reflect.isExtensible(target)

Reflect.isExtensible(target) връща true, когато обектът може да се разширява, и false, когато не може. При обикновен обект това означава, че към него могат да се добавят нови собствени свойства. Методът проверява състоянието, но сам не го променя.

Object.preventExtensions(target) предотвратява добавянето на нови собствени свойства. Object.seal(target) и Object.freeze(target) също правят обектите неразширяеми, но налагат и допълнителни ограничения. Следователно false не означава, че обектът е замразен: съществуващите записваеми свойства все още могат да се променят, а конфигурируемите свойства могат да се изтриват. Обикновен обект не може отново да стане разширяем.

Аргументът трябва да е обект; масивите и функциите също са обекти. Примитивните стойности, включително null и undefined, причиняват TypeError. Това е важна разлика спрямо Object.isExtensible(target), който връща false за примитивни стойности, вместо да хвърли грешка.

Методът извиква вътрешната операция [[IsExtensible]]. При Proxy може да бъде извикана клопката isExtensible, затова не приемайте, че методът няма странични ефекти. След преобразуване до булева стойност резултатът от клопката трябва да съответства на действителната разширяемост на целевия обект; в противен случай възниква TypeError. Отменен proxy също причинява TypeError.

Примери

const item = { count: 1 };
console.log(Reflect.isExtensible(item));

Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));

item.count = 2;
console.log(item.count);

try {
  Reflect.isExtensible(42);
} catch (error) {
  console.log(error.name);
}

Резултат

true
false
false
2
TypeError

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

Източници