CKTIS / JavaScript
Object.preventExtensions — zabránění přidávání nových vlastností
Object.preventExtensions(obj) nevratně zabrání přidávání vlastních vlastností do objektu a vrátí tentýž objekt. Existující hodnoty ani vnořené objekty tím nezmrazí.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.preventExtensions(obj)Object.preventExtensions(obj) nastaví objekt jako nerozšiřitelný: nelze přidávat nové vlastní vlastnosti, ani vlastnosti s klíči typu symbol. Metoda změní předaný objekt a vrátí stejnou referenci, nikoli kopii. Stav lze ověřit pomocí Object.isExtensible(obj). Operaci nelze vrátit zpět.
U běžného objektu si existující vlastnosti zachovají své deskriptory: do zapisovatelných vlastností lze dál zapisovat a konfigurovatelné vlastnosti lze dál mazat. Smazanou vlastnost nelze znovu přidat. Je také zakázáno změnit prototyp na jiný; zadání stávajícího prototypu zůstává povoleno.
Typované pole s pevnou délkou, které používá ArrayBuffer s neměnnou velikostí, lze nastavit jako nerozšiřitelné. Jeho existující indexované prvky však nelze smazat, přestože jejich deskriptory uvádějí configurable: true.
Přiřazení, které by vytvořilo novou vlastní vlastnost, vyvolá v přísném režimu TypeError a mimo něj se obvykle ignoruje. Object.defineProperty vyvolá TypeError, pokud se pomocí něj přidává vlastnost, bez ohledu na režim. Samotná metoda také vyvolá TypeError, pokud interní operace odmítne rozšiřování zakázat, například kvůli pasti Proxy, která vrátí false. V současném ECMAScriptu se primitivní argumenty, včetně null a undefined, vracejí beze změny.
Object.seal poskytuje silnější ochranu: u všech vlastních vlastností nastaví configurable na false, takže je nelze smazat. U zapečetěného běžného objektu lze atribut writable zapisovatelné datové vlastnosti stále změnit z true na false. U zapečetěného objektu jmenného prostoru modulu uvádějí deskriptory vlastností odpovídajících exportovaným vazbám writable: true, objekt však změnu tohoto atributu na false odmítá. U běžného objektu Object.freeze navíc nastaví writable na false u všech vlastních datových vlastností. U objektu jmenného prostoru modulu vyvolá Object.freeze chybu TypeError, když se pokusí nastavit writable na false u vlastnosti odpovídající exportované vazbě. Pokud tato vazba ještě není inicializovaná, může už získání deskriptoru vlastnosti vyvolat ReferenceError, ještě než k tomuto pokusu dojde. Žádná z těchto operací nepůsobí rekurzivně na vnořené objekty. Jde o API jazyka ECMAScript, nikoli o webové API prohlížeče; samotný standard nedokládá podporu v konkrétním prohlížeči.
Příklady
"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"));Výsledek
true false 2 true TypeError false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.