Reflect.isExtensible()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016年9月.

Reflect.isExtensible() は静的メソッドで、これは Object.isExtensible() に似ています。これはオブジェクトが拡張可能であるか（オブジェクトに追加された新しいプロパティを持てるかどうか）を判断します。

試してみましょう

const object1 = {};

console.log(Reflect.isExtensible(object1));
// 予想される結果: true

Reflect.preventExtensions(object1);

console.log(Reflect.isExtensible(object1));
// 予想される結果: false

const object2 = Object.seal({});

console.log(Reflect.isExtensible(object2));
// 予想される結果: false

構文

Reflect.isExtensible(target)

Reflect.isExtensible() は、オブジェクトが拡張可能かどうかを調べる反射的な意味づけを提供します。Object.isExtensible() との唯一の違いは、オブジェクト以外の対象の処理方法です。Reflect.isExtensible() は対象がオブジェクトでない場合に TypeError を発生しますが、Object.isExtensible() はオブジェクト以外の対象に対して常に false を返します。

Reflect.isExtensible() は、target の [[IsExtensible]] オブジェクト内部メソッドを呼び出します。

例

Reflect.isExtensible() の使用

Object.isExtensible() も参照してください。

js
// 新しいオブジェクトは拡張可能。
const empty = {};
Reflect.isExtensible(empty); // true

// ...しかし、変更できます
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // false

// 封印されたオブジェクトは拡張できないように定義される。
const sealed = Object.seal({});
Reflect.isExtensible(sealed); // false

// 凍結されたオブジェクトも拡張できないように定義される。
const frozen = Object.freeze({});
Reflect.isExtensible(frozen); // false

Object.isExtensible() との違い

このメソッドへの最初の引数がオブジェクトではなかった (プリミティブであった) 場合、これは TypeError を引き起こします。Object.isExtensible() だと、オブジェクトではない最初の引数はオブジェクトに強制的に変換されます。

js
Reflect.isExtensible(1);
// TypeError: 1 はオブジェクトではない

Object.isExtensible(1);
// false

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-reflect.isextensible

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2026年3月5日 by MDN contributors.

View this page on GitHub • Report a problem with this content