Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Reflect.preventExtensions — blokowanie rozszerzania obiektu

Reflect.preventExtensions(target) blokuje dodawanie nowych właściwości własnych do obiektu i zwraca wynik logiczny. Nie zamraża istniejących właściwości i może zgłaszać wyjątki.

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.preventExtensions(target)

Reflect.preventExtensions(target) wywołuje wewnętrzną operację [[PreventExtensions]] obiektu. Zwraca true, jeśli operacja się powiedzie, albo false, jeśli zostanie odrzucona. Argument musi być obiektem; wartość pierwotna, w tym null, powoduje TypeError. Wyjątki z operacji wewnętrznej są przekazywane dalej — wynik logiczny nie oznacza braku wyjątków.

Dla zwykłego obiektu sukces trwale uniemożliwia dodawanie nowych właściwości własnych, również o kluczach typu Symbol. Ponowne wywołanie zwraca true. Nie można też zmienić prototypu na inny. Istniejące właściwości nadal można zmieniać lub usuwać, jeśli pozwalają na to ich deskryptory; obiekty zagnieżdżone nie są modyfikowane.

To nie jest odpowiednik Object.seal ani Object.freeze: metoda nie zmienia atrybutów configurable ani writable. Object.preventExtensions zwraca argument przy sukcesie i zgłasza TypeError, gdy operacja zwróci false; wartości pierwotne zwraca bez zmian. Reflect.preventExtensions zamiast tego udostępnia wynik logiczny i odrzuca wartości pierwotne.

Obiekt Proxy może przechwycić operację przez pułapkę preventExtensions. Pułapka może odmówić, zwracając false, ale zgłoszenie sukcesu, gdy obiekt docelowy nadal jest rozszerzalny, powoduje TypeError. W przykładzie Reflect.set pokazuje nieudaną próbę dodania właściwości bez zależności od trybu ścisłego.

Przykłady

const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));

Wynik

true
false
false
2
true
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła