CKTIS / JavaScript
Reflect.preventExtensions — preprečevanje razširjanja objekta
Reflect.preventExtensions(target) prepreči dodajanje novih lastnih lastnosti objektu in vrne logično vrednost. Obstoječih lastnosti ne zamrzne, še vedno pa lahko povzroči izjeme.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Reflect.preventExtensions(target)Reflect.preventExtensions(target) pokliče notranjo operacijo objekta [[PreventExtensions]]. Če je operacija uspešna, vrne true, sicer false. Argument mora biti objekt; primitivna vrednost, vključno z null, povzroči TypeError. Izjeme notranje operacije se posredujejo naprej — logična vrnjena vrednost ne pomeni, da izjeme niso mogoče.
Pri običajnem objektu uspeh trajno prepreči dodajanje novih lastnih lastnosti, tudi tistih s ključem vrste Symbol. Ponovni klic vrne true. Tudi prototipa ni več mogoče spremeniti v drugega. Obstoječe lastnosti je še vedno mogoče spreminjati ali brisati, če to dovoljujejo njihovi deskriptorji; ugnezdeni objekti se ne spremenijo.
To ni enakovredno Object.seal ali Object.freeze: metoda ne spremeni atributov configurable ali writable. Object.preventExtensions ob uspehu vrne svoj argument, ob vrnitvi false iz operacije pa sproži TypeError; primitivne vrednosti vrne nespremenjene. Reflect.preventExtensions namesto tega izpostavi logični rezultat in zavrne primitivne vrednosti.
Objekt Proxy lahko operacijo prestreže s pastjo preventExtensions. Past jo lahko zavrne tako, da vrne false, vendar prijava uspeha, ko je ciljni objekt še vedno razširljiv, povzroči TypeError. V primeru Reflect.set pokaže neuspešen poskus dodajanja lastnosti, ki ni odvisen od strogega načina.
Primeri
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"));Rezultat
true false false 2 true false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.