Object.isExtensible()

The Object.isExtensible() метод визначає чи об'єкт є розширюваним (чи може об'єкт бути доповнений новими властивостями).

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Синтаксис

Object.isExtensible(obj)

Параметри

obj

об'єкт, який необхідно перевірити.

Вихідне значення

Булеве значення що визначає чи є об'єкт розширюваним.

Опис

За замовчуванням об'єкти є розширюваними: нові властивості можуть додаватися до них і (у двигунах, що підтримують __proto__ їх __proto__ властивість) можуть модифікуватися. Об'єкт можна зробити нерозширюваним за допомогою Object.preventExtensions(), Object.seal(), or Object.freeze().

Приклади

// Нові об'єкти є розширюваними.
var empty = {};
Object.isExtensible(empty); // === true

// ...але це можна змінити.
Object.preventExtensions(empty);
Object.isExtensible(empty); // === false

// "Запечатані" об'єкти є за означенням нерозширюваними.
var sealed = Object.seal({});
Object.isExtensible(sealed); // === false

// "Заморожені" об'єкти також за означенням є нерозширюваними.
var frozen = Object.freeze({});
Object.isExtensible(frozen); // === false

Примітки

У ES5, якщо аргументом даного методу виступає не об'єкт, а примітивне значення, це спричинить помилку TypeError. У ES2015 ж, якщо аргументом методу буде не об'єкт, він буде сприйнятий методом так, наче б це був звичайний нерозширюваний об'єкт, тобто вихідним значенням буде false.

Object.isExtensible(1);
// TypeError: 1 is not an object (ES5 code)

Object.isExtensible(1);
// false                         (ES2015 code)

Specifications

Browser compatibility

See also

• Object.preventExtensions()
• Object.seal()
• Object.isSealed()
• Object.freeze()
• Object.isFrozen()
• Reflect.isExtensible()