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));
// Expected output: true

Reflect.preventExtensions(object1);

console.log(Reflect.isExtensible(object1));
// Expected output: false

const object2 = Object.seal({});

console.log(Reflect.isExtensible(object2));
// Expected output: false

구문

Reflect.isExtensible(target);

매개변수

target: 확장 가능 여부를 판별할 대상 객체.

반환 값

객체의 확장 가능 여부를 나타내는 Boolean.

예외

target이 Object가 아니면 TypeError.

설명

Reflect.isExtensible() 메서드는 Object.isExtensible()와 유사하게, 객체에 새로운 속성을 추가할 수 있는지 판별합니다.

예제

`Reflect.isExtensible()` 사용하기

Object.isExtensible()도 참고하세요.

// 새로운 객체는 확장 가능
var empty = {};
Reflect.isExtensible(empty); // === true

// ...하지만 바꿀 수 있음
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // === false

// 봉인한 객체는 확장 불가능함
var sealed = Object.seal({});
Reflect.isExtensible(sealed); // === false

// 동결한 객체도 확장 불가능함
var frozen = Object.freeze({});
Reflect.isExtensible(frozen); // === false

`Object.isExtensible()`과의 차이점

Reflect.isExtensible()은 첫 번째 매개변수가 원시값이면 TypeError를 던집니다. 반면 Object.isExtensible()은 우선 객체로 변환을 시도합니다.

Reflect.isExtensible(1);
// TypeError: 1 is not an object

Object.isExtensible(1);
// false

명세

Specification
ECMAScript® 2026 Language Specification # sec-reflect.isextensible

브라우저 호환성

같이 보기

Help improve MDN

Learn how to contribute

This page was last modified on ⁨2025년 2월 11일⁩ by MDN contributors.

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