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.