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

CKTIS / JavaScript

Object.isExtensible: дали обект приема нови свойства

Object.isExtensible връща boolean, който показва дали към обекта още могат да се добавят нови собствени свойства.

Версия: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2

Синтаксис

Object.isExtensible(obj)

Object.isExtensible(obj) извиква вътрешния метод [[IsExtensible]] на обекта и връща неговия boolean. Нов обикновен обект е extensible. Object.preventExtensions, Object.seal и Object.freeze променят това състояние на false; при обикновен обект то не може да се възстанови.

Non-extensible състоянието блокира нови собствени свойства, но само по себе си не замразява съществуващите. Съществуващо writable свойство може да променя стойност, а configurable може да се изтрие или промени според descriptor. Затова false не е равнозначно на Object.isSealed или Object.isFrozen.

Методът съществува от ECMAScript 5; от ECMAScript 2015 всеки примитив просто връща false, вместо да хвърля. Proxy може да изпълни trap isExtensible, чийто резултат става boolean. Той трябва да съвпада с реалното състояние на target, иначе се хвърля TypeError; изключение от trap също се разпространява.

Примери

const open = { value: 1 };
const closed = Object.preventExtensions({ value: 1 });

console.log(Object.isExtensible(open), Object.isExtensible(closed));
closed.value = 2;
console.log(closed.value, Reflect.defineProperty(closed, "extra", { value: 3 }));
console.log(Object.isExtensible(7));

const proxy = new Proxy(closed, { isExtensible() { return true; } });
try { Object.isExtensible(proxy); } catch (error) { console.log(error.name); }

Резултат

true false
2 false
false
TypeError

Примерът сравнява отворен и затворен обект, променя стойност, отказва ново свойство и проверява Proxy invariant.

Източници