Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła