CKTIS / JavaScript
Object.seal — uszczelnianie obiektu
Object.seal blokuje dodawanie i usuwanie własnych właściwości obiektu, ale nie czyni go niezmiennym. W zwykłych obiektach nadal można zmieniać wartości istniejących zapisywalnych właściwości danych, a obiekty zagnieżdżone nie są automatycznie uszczelniane.
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.seal(obj)Object.seal(obj) modyfikuje przekazany obiekt i zwraca ten sam obiekt, bez tworzenia kopii. Uniemożliwia jego rozszerzanie i ustawia configurable: false dla wszystkich własnych właściwości, także nieenumerowalnych i o kluczach typu Symbol. Nie można później dodawać ani usuwać własnych właściwości, zmieniać ich enumerowalności ani zamieniać właściwości danych na akcesory i odwrotnie.
Uszczelnienie nie oznacza niezmienności. W zwykłym obiekcie istniejącym właściwościom danych z writable: true nadal można przypisywać nowe wartości, a writable można zmienić z true na false, ale nie odwrotnie. W uszczelnionym obiekcie przestrzeni nazw modułu deskryptory właściwości odpowiadających eksportom wskazują writable: true, ale obiekt odrzuca zarówno przypisania do tych właściwości, jak i próby zmiany ich writable na false. Istniejące settery nadal mogą działać. Operacja jest płytka: obiekty zagnieżdżone nie są automatycznie uszczelniane.
Object.preventExtensions blokuje dodawanie własnych właściwości, ale samo nie odbiera możliwości konfiguracji istniejących. W zwykłym obiekcie Object.freeze dodatkowo ustawia writable: false dla własnych właściwości danych; również działa płytko. Stan uszczelnienia sprawdza Object.isSealed.
W trybie ścisłym niedozwolone przypisanie nowej właściwości lub usunięcie istniejącej przez delete powoduje TypeError; poza nim takie operacje zwykle zawodzą bez wyjątku. Object.seal może zgłosić wyjątek, jeśli uszczelnienie się nie powiedzie, na przykład dla niektórych obiektów Proxy. We współczesnym ECMAScript argument niebędący obiektem jest zwracany bez zmian.
Przykłady
"use strict";
const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;
console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);
try {
settings.extra = 1;
} catch (error) {
console.log(error instanceof TypeError);
}
console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));Wynik
true true 3 true true false false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.