CKTIS / JavaScript
Reflect.setPrototypeOf — nastavitev prototipa objekta
Reflect.setPrototypeOf(target, proto) poskuša nastaviti prototip objekta in vrne logično vrednost. Tako je zavrnitev spremembe mogoče razlikovati od neveljavnih argumentov, ki povzročijo 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.setPrototypeOf(target, proto)Reflect.setPrototypeOf(target, proto) pokliče notranjo operacijo [[SetPrototypeOf]] objekta target. Prototip se uporablja za iskanje podedovanih lastnosti; metoda jih ne kopira v objekt. proto mora biti objekt ali null, kar pomeni, da objekt nima prototipa. To ne spremeni lastnosti .prototype funkcije.
Rezultat true pomeni uspeh, tudi če je zahtevani prototip že nastavljen. Rezultat false pomeni zavrnitev. Pri običajnem objektu sprememba na drug prototip po klicu Object.preventExtensions(target) vrne false. Ponovna nastavitev istega prototipa je dovoljena tudi pri objektu, ki ga ni mogoče razširiti. Pri preverjanju cikla za običajen objekt operacija vrne false, če pri pregledovanju verige od proto doseže target. Preverjanje pa se ustavi, ko naleti na objekt, ki ne uporablja običajne notranje metode [[GetPrototypeOf]]. Objekt Proxy v verigi lahko zato omogoči nastanek cikla, tudi če je target običajen objekt.
Logična vrnjena vrednost ne zagotavlja, da ne bo prišlo do izjem: primitivni target ali neveljaven proto povzroči TypeError. Napake notranje operacije, vključno z napakami pasti Proxy, se posredujejo naprej. Nasprotno pa Object.setPrototypeOf pri objektu target ob uspehu vrne objekt in sproži TypeError, kadar notranja operacija vrne false.
Primer prikazuje dedovanje brez kopiranja ter razliko med ohranitvijo in spremembo prototipa po preprečitvi razširitev. Jezikovna specifikacija ni tabela združljivosti brskalnikov; uporaba Node 24 v repozitoriju ne potrjuje podpore v brskalnikih.
Primeri
const proto = { label: "shared" };
const item = {};
console.log(Reflect.setPrototypeOf(item, proto));
console.log(item.label);
console.log(Object.hasOwn(item, "label"));
Object.preventExtensions(item);
console.log(Reflect.setPrototypeOf(item, proto));
console.log(Reflect.setPrototypeOf(item, null));
console.log(Object.getPrototypeOf(item) === proto);Rezultat
true shared false true false true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.