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

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.

Viri