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

CKTIS / JavaScript

Object.isFrozen — preverjanje, ali je objekt zamrznjen

Object.isFrozen(value) preveri, ali je objekt nerazširljiv, ali so vse njegove lastne lastnosti nekonfigurabilne in ali so njegove lastne podatkovne lastnosti poleg tega nezapisljive. Metoda objekta ne zamrzne in ne preverja rekurzivno ugnezdenih objektov.

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

Object.isFrozen(value)

Object.isFrozen(value) je statična metoda, ki vrne true, kadar objektu ni mogoče dodati lastnih lastnosti, imajo vse njegove lastne lastnosti configurable: false, njegove lastne podatkovne lastnosti pa imajo tudi writable: false. Upoštevani so simbolni ključi in neenumerabilne lastnosti, podedovane lastnosti pa ne.

Metoda pregleda stanje, namesto da bi ga spreminjala; za zamrznitev objekta uporabite Object.freeze. Sam Object.seal ne zadošča, če ostanejo zapisljive podatkovne lastnosti. Prazen objekt pa je po Object.preventExtensions že zamrznjen, saj nima lastnosti, ki bi kršile preostale pogoje.

Rezultat true ne pomeni globoke nespremenljivosti. Objekti, shranjeni kot vrednosti lastnosti, se lahko še vedno spreminjajo. Dostopne lastnosti lahko ohranijo setterje, getterji pa lahko vračajo različne rezultate; preverjanje ne zahteva njihove odstranitve in ne pokliče getterjev običajnega objekta.

Za primitivne vrednosti, vključno z null in undefined, trenutna specifikacija vrne true. Pri Proxy lahko pregled sproži pasti in povzroči izjemo, zato operacija ni vedno brez stranskih učinkov.

Primeri

const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));

Rezultat

false
true
false
true
true
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