CKTIS / JavaScript
Object.preventExtensions — preprečevanje dodajanja novih lastnosti
Object.preventExtensions(obj) nepovratno prepreči dodajanje lastnih lastnosti objektu in vrne isti objekt. Obstoječih vrednosti ali ugnezdenih objektov ne zamrzne.
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.preventExtensions(obj)Object.preventExtensions(obj) naredi objekt ne-razširljiv: dodajanje novih lastnih lastnosti ni mogoče, tudi če imajo ključe vrste symbol. Metoda spremeni podani objekt in vrne isto referenco, ne kopije. Stanje lahko preverite z Object.isExtensible(obj). Operacije ni mogoče razveljaviti.
Pri navadnem objektu obstoječe lastnosti ohranijo svoje deskriptorje: zapisljivim lastnostim je še vedno mogoče dodeliti vrednost, konfigurabilne pa je mogoče izbrisati. Izbrisane lastnosti ni mogoče znova dodati. Prav tako ni dovoljeno zamenjati prototipa z drugim; navedba obstoječega prototipa ostaja dovoljena.
Tipizirano polje s fiksno dolžino, ki uporablja ArrayBuffer z nespremenljivo velikostjo, je mogoče narediti nerazširljivo. Njegovih obstoječih indeksiranih elementov pa ni mogoče izbrisati, čeprav njihovi deskriptorji navajajo configurable: true.
Dodelitev, ki bi ustvarila novo lastno lastnost, v strogem načinu sproži TypeError, zunaj njega pa je običajno prezrta. Object.defineProperty sproži TypeError, kadar poskuša dodati lastnost, ne glede na način. Tudi sama metoda sproži TypeError, če notranja operacija zavrne preprečitev razširitve, na primer zaradi pasti Proxy, ki vrne false. V trenutnem ECMAScriptu se primitivni argumenti, vključno z null in undefined, vrnejo nespremenjeni.
Object.seal zagotavlja močnejšo zaščito: pri vseh lastnih lastnostih nastavi configurable na false, zato jih ni mogoče izbrisati. Pri zapečatenem navadnem objektu je atribut writable zapisljive podatkovne lastnosti še vedno mogoče spremeniti iz true v false. Pri zapečatenem objektu imenskega prostora modula deskriptorji lastnosti, ki ustrezajo izvoženim vezavam, navajajo writable: true, vendar objekt zavrne spremembo tega atributa na false. Pri navadnem objektu Object.freeze poleg tega nastavi writable na false pri vseh lastnih podatkovnih lastnostih. Pri objektu imenskega prostora modula Object.freeze sproži TypeError, ko poskuša nastaviti writable na false pri lastnosti, ki ustreza izvoženi vezavi. Če ta vezava še ni inicializirana, lahko pridobivanje deskriptorja lastnosti sproži ReferenceError že pred tem poskusom. Nobena od teh operacij ne deluje rekurzivno na ugnezdene objekte. To je API jezika ECMAScript, ne spletni API brskalnika; sam standard ne potrjuje podpore v določenem brskalniku.
Primeri
"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
item.extra = 3;
} catch (error) {
console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));Rezultat
true false 2 true TypeError false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.