Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.isExtensible: czy obiekt przyjmuje nowe właściwości

Object.isExtensible zwraca boolean wskazujący, czy do obiektu można jeszcze dodawać nowe własne właściwości.

Wersja: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2

Składnia

Object.isExtensible(obj)

Object.isExtensible(obj) dla obiektu wywołuje wewnętrzne [[IsExtensible]] i zwraca jego boolean. Zwykły nowy obiekt jest ekstensywny. Object.preventExtensions, Object.seal i Object.freeze zmieniają ten stan na false; dla zwykłego obiektu nie można potem przywrócić ekstensywności.

Brak ekstensywności blokuje dodawanie nowych własnych właściwości, lecz sam nie zamraża istniejących. Istniejąca właściwość zapisywalna może nadal zmieniać wartość, a konfigurowalna może być usunięta lub przeformowana w granicach jej deskryptora. Dlatego wynik false nie jest równoważny Object.isSealed ani Object.isFrozen.

Metoda istnieje od ECMAScript 5; od ECMAScript 2015 dla każdej wartości pierwotnej zwraca false zamiast rzucać. Proxy może uruchomić pułapkę isExtensible, której wynik jest konwertowany do boolean. Musi on zgadzać się z rzeczywistym stanem celu, w przeciwnym razie powstaje TypeError; wyjątek pułapki także się propaguje.

Przykłady

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); }

Wynik

true false
2 false
false
TypeError

Przykład porównuje obiekt otwarty i zamknięty, zmienia istniejącą wartość, odrzuca nową właściwość i pokazuje invariant Proxy.

Źródła