CKTIS / JavaScript
Object.preventExtensions — zabránenie pridávaniu nových vlastností
Object.preventExtensions(obj) nevratne zabráni pridávaniu vlastných vlastností do objektu a vráti ten istý objekt. Existujúce hodnoty ani vnorené objekty tým nezmrazí.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Object.preventExtensions(obj)Object.preventExtensions(obj) nastaví objekt ako nerozšíriteľný: nemožno pridávať nové vlastné vlastnosti, ani vlastnosti s kľúčmi typu symbol. Metóda zmení odovzdaný objekt a vráti tú istú referenciu, nie kópiu. Stav možno overiť pomocou Object.isExtensible(obj). Operáciu nemožno vrátiť späť.
Pri bežnom objekte si existujúce vlastnosti zachovajú svoje deskriptory: do zapisovateľných vlastností možno naďalej zapisovať a konfigurovateľné vlastnosti možno naďalej mazať. Zmazanú vlastnosť nemožno znova pridať. Prototyp tiež nemožno zmeniť na iný; zadanie existujúceho prototypu zostáva povolené.
Typované pole s pevnou dĺžkou, ktoré používa ArrayBuffer s nemennou veľkosťou, možno nastaviť ako nerozšíriteľné. Jeho existujúce indexované prvky však nemožno odstrániť, hoci ich deskriptory uvádzajú configurable: true.
Priradenie, ktoré by vytvorilo novú vlastnú vlastnosť, vyvolá v prísnom režime TypeError a mimo neho sa zvyčajne ignoruje. Object.defineProperty vyvolá TypeError, ak sa pomocou neho pridáva vlastnosť, bez ohľadu na režim. Samotná metóda tiež vyvolá TypeError, ak interná operácia odmietne zabrániť rozširovaniu, napríklad pre pascu Proxy, ktorá vráti false. V súčasnom ECMAScripte sa primitívne argumenty vrátane null a undefined vracajú bez zmeny.
Object.seal poskytuje silnejšiu ochranu: pri všetkých vlastných vlastnostiach nastaví configurable na false, takže ich nemožno odstrániť. Pri zapečatenom bežnom objekte možno atribút writable zapisovateľnej dátovej vlastnosti stále zmeniť z true na false. Pri zapečatenom objekte menného priestoru modulu uvádzajú deskriptory vlastností zodpovedajúcich exportovaným väzbám writable: true, objekt však zmenu tohto atribútu na false odmieta. Pri bežnom objekte Object.freeze navyše nastaví writable na false pri všetkých vlastných dátových vlastnostiach. Pri objekte menného priestoru modulu vyvolá Object.freeze chybu TypeError, keď sa pokúsi nastaviť writable na false pri vlastnosti zodpovedajúcej exportovanej väzbe. Ak táto väzba ešte nie je inicializovaná, už získanie deskriptora vlastnosti môže vyvolať ReferenceError pred týmto pokusom. Žiadna z týchto operácií nepôsobí rekurzívne na vnorené objekty. Ide o API jazyka ECMAScript, nie o webové API prehliadača; samotný štandard nedokladá podporu v konkrétnom prehliadači.
Prí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ýsledok
true false 2 true TypeError false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.