Метод 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()
або 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) Object.isExtensible(1); // false (код ES2015)
Специфікації
Специфікація | Статус | Коментар |
---|---|---|
ECMAScript 5.1 (ECMA-262) The definition of 'Object.isExtensible' in that specification. |
Standard | Початкове визначення. Реалізоване у JavaScript 1.8.5. |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Object.isExtensible' in that specification. |
Standard | |
ECMAScript Latest Draft (ECMA-262) The definition of 'Object.isExtensible' in that specification. |
Draft |
Сумісність з веб-переглядачами
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
isExtensible | Chrome Full support 6 | Edge Full support 12 | Firefox Full support 4 | IE Full support 9 | Opera Full support 12 | Safari Full support 5.1 | WebView Android Full support Yes | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes |
Legend
- Full support
- Full support