CKTIS / JavaScript
Reflect.isExtensible — sprawdzanie rozszerzalności obiektu
Reflect.isExtensible(target) sprawdza, czy obiekt jest rozszerzalny. Dla zwykłego obiektu rozszerzalność oznacza, że można dodawać do niego nowe właściwości własne. Metoda zwraca wartość logiczną, a dla wartości pierwotnych zgłasza TypeError.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Reflect.isExtensible(target)Reflect.isExtensible(target) zwraca true, gdy obiekt jest rozszerzalny, albo false, gdy nie jest. Dla zwykłego obiektu rozszerzalność oznacza możliwość dodawania nowych właściwości własnych. Metoda odczytuje ten stan; sama go nie zmienia.
Object.preventExtensions(target) blokuje dodawanie nowych właściwości własnych. Object.seal(target) i Object.freeze(target) również powodują nierozszerzalność, ale nakładają dodatkowe ograniczenia. Wynik false nie oznacza więc, że obiekt jest zamrożony: istniejące zapisywalne właściwości nadal można zmieniać, a konfigurowalne usuwać. Zwykłego obiektu nie można ponownie uczynić rozszerzalnym.
Argument musi być obiektem; tablice i funkcje także są obiektami. Wartości pierwotne, w tym null i undefined, powodują TypeError. To ważna różnica względem Object.isExtensible(target), które dla wartości pierwotnych zwraca false zamiast zgłaszać wyjątek.
Metoda wywołuje wewnętrzną operację [[IsExtensible]]. Dla Proxy może uruchomić pułapkę isExtensible, więc nie należy zakładać braku efektów ubocznych. Wynik pułapki po konwersji na wartość logiczną musi odpowiadać rzeczywistej rozszerzalności obiektu docelowego, inaczej wystąpi TypeError. Odwołane proxy również powoduje TypeError.
Przykłady
const item = { count: 1 };
console.log(Reflect.isExtensible(item));
Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
try {
Reflect.isExtensible(42);
} catch (error) {
console.log(error.name);
}Wynik
true false false 2 TypeError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.