CKTIS / JavaScript
Reflect.isExtensible — preverjanje razširljivosti objekta
Reflect.isExtensible(target) preveri, ali je objekt razširljiv. Pri običajnem objektu to pomeni, da mu je mogoče dodati nove lastne lastnosti. Metoda vrne logično vrednost, pri primitivnih vrednostih pa sproži TypeError.
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.isExtensible(target)Reflect.isExtensible(target) vrne true, če je objekt razširljiv, sicer pa false. Pri običajnem objektu razširljivost pomeni, da mu je mogoče dodati nove lastne lastnosti. Metoda to stanje prebere, vendar ga sama ne spremeni.
Object.preventExtensions(target) prepreči dodajanje novih lastnih lastnosti. Tudi Object.seal(target) in Object.freeze(target) naredita objekte nerazširljive, vendar uvedeta dodatne omejitve. Zato false ne pomeni, da je objekt zamrznjen: obstoječe zapisljive lastnosti je še vedno mogoče spreminjati, nastavljive lastnosti pa brisati. Običajnega objekta ni mogoče znova narediti razširljivega.
Argument mora biti objekt; tudi polja in funkcije so objekti. Primitivne vrednosti, vključno z null in undefined, povzročijo TypeError. To je pomembna razlika v primerjavi z Object.isExtensible(target), ki za primitive vrne false, namesto da bi sprožila izjemo.
Metoda pokliče notranjo operacijo [[IsExtensible]]. Pri Proxy lahko pokliče past isExtensible, zato ne predpostavljajte, da nima stranskih učinkov. Po pretvorbi v logično vrednost se mora rezultat pasti ujemati z dejansko razširljivostjo ciljnega objekta; sicer pride do napake TypeError. Tudi preklicani proxy povzroči TypeError.
Primeri
const item = { count: 1 };
console.log(Reflect.isExtensible(item));
Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
try {
Reflect.isExtensible(42);
} catch (error) {
console.log(error.name);
}Rezultat
true false false 2 TypeError
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.