CKTIS / JavaScript
Object.preventExtensions — blokowanie nowych właściwości
Object.preventExtensions(obj) nieodwracalnie blokuje dodawanie własnych właściwości do obiektu i zwraca ten sam obiekt. Nie zamraża istniejących wartości ani obiektów zagnieżdżonych.
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
Object.preventExtensions(obj)Object.preventExtensions(obj) sprawia, że obiekt staje się nierozszerzalny: nie można dodawać nowych właściwości własnych, także o kluczach typu symbol. Metoda zmienia przekazany obiekt i zwraca tę samą referencję, nie kopię. Object.isExtensible(obj) pozwala sprawdzić stan. Operacji nie można cofnąć.
W zwykłym obiekcie istniejące właściwości zachowują swoje deskryptory: do właściwości zapisywalnych nadal można przypisywać wartości, a właściwości konfigurowalne można usuwać. Usuniętej właściwości nie można ponownie dodać. Nie można też zmienić prototypu na inny; wskazanie dotychczasowego prototypu pozostaje dozwolone.
Tablicę typowaną o stałej długości opartą na buforze ArrayBuffer o niezmiennym rozmiarze można uczynić nierozszerzalną, ale jej istniejących elementów indeksowanych nie można usunąć, mimo że ich deskryptory wskazują configurable: true.
Przypisanie tworzące nową właściwość własną kończy się TypeError w trybie ścisłym, a poza nim zwykle jest ignorowane. Object.defineProperty zgłasza TypeError przy próbie dodania właściwości niezależnie od trybu. Sama metoda również zgłasza TypeError, jeśli wewnętrzna operacja odmówi blokady, na przykład przez pułapkę Proxy zwracającą false. W aktualnym ECMAScript argumenty pierwotne, w tym null i undefined, są zwracane bez zmian.
Object.seal zapewnia silniejszą ochronę: ustawia configurable na false dla wszystkich właściwości własnych, więc nie można ich usunąć. W zapieczętowanym zwykłym obiekcie atrybut writable zapisywalnej właściwości danych nadal można zmienić z true na false. Zapieczętowany obiekt przestrzeni nazw modułu zwraca deskryptory z writable: true dla właściwości odpowiadających eksportowanym wiązaniom, ale odrzuca zmianę tego atrybutu na false. W zwykłym obiekcie Object.freeze dodatkowo ustawia writable na false dla wszystkich własnych właściwości danych. W przypadku obiektu przestrzeni nazw modułu Object.freeze zgłasza TypeError, gdy próbuje ustawić writable na false dla właściwości odpowiadającej eksportowanemu wiązaniu. Jeśli to wiązanie nie zostało jeszcze zainicjalizowane, już pobranie deskryptora właściwości może zgłosić ReferenceError, zanim dojdzie do tej próby. Żadna z tych operacji nie działa rekurencyjnie na obiektach zagnieżdżonych. Jest to API języka ECMAScript, nie przeglądarkowe Web API; sam standard nie potwierdza obsługi w konkretnej przeglądarce.
Przykłady
"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
item.extra = 3;
} catch (error) {
console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));Wynik
true false 2 true TypeError false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.