Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri