Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Object.preventExtensions — sprječavanje dodavanja novih svojstava

Object.preventExtensions(obj) nepovratno sprječava dodavanje vlastitih svojstava objektu i vraća taj isti objekt. Ne zamrzava postojeće vrijednosti ni ugniježđene objekte.

Verzija: 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) čini objekt neproširivim: nije moguće dodati nova vlastita svojstva, uključujući ona s ključevima vrste symbol. Metoda mijenja predani objekt i vraća istu referencu, a ne kopiju. Stanje možete provjeriti pomoću Object.isExtensible(obj). Operaciju nije moguće poništiti.

Kod običnog objekta postojeća svojstva zadržavaju svoje deskriptore: zapisivim svojstvima i dalje se mogu dodjeljivati vrijednosti, a konfigurabilna svojstva i dalje se mogu brisati. Obrisano svojstvo ne može se ponovno dodati. Prototip se također ne može zamijeniti drugim; navođenje postojećeg prototipa i dalje je dopušteno.

Tipizirano polje fiksne duljine koje koristi ArrayBuffer nepromjenjive veličine može se učiniti neproširivim. Njegovi postojeći indeksirani elementi ne mogu se izbrisati iako njihovi deskriptori navode configurable: true.

Dodjela koja bi stvorila novo vlastito svojstvo u strogom načinu rada uzrokuje TypeError, a izvan njega se obično zanemaruje. Object.defineProperty uzrokuje TypeError pri pokušaju dodavanja svojstva, bez obzira na način rada. I sama metoda uzrokuje TypeError ako interna operacija odbije spriječiti proširivanje, primjerice zbog zamke Proxy koja vraća false. U aktualnom ECMAScriptu primitivni argumenti, uključujući null i undefined, vraćaju se nepromijenjeni.

Object.seal pruža jaču zaštitu: postavlja configurable na false za sva vlastita svojstva pa ih nije moguće izbrisati. Kod zapečaćenog običnog objekta atribut writable zapisivog podatkovnog svojstva i dalje se može promijeniti iz true u false. Kod zapečaćenog objekta prostora imena modula deskriptori svojstava koja odgovaraju izvezenim vezama navode writable: true, ali objekt odbija promjenu tog atributa na false. Kod običnog objekta Object.freeze dodatno postavlja writable na false za sva vlastita podatkovna svojstva. Kod objekta prostora imena modula Object.freeze uzrokuje TypeError kad pokuša postaviti writable na false za svojstvo koje odgovara izvezenoj vezi. Ako ta veza još nije inicijalizirana, dohvaćanje deskriptora svojstva može uzrokovati ReferenceError prije tog pokušaja. Nijedna od tih operacija ne djeluje rekurzivno na ugniježđene objekte. Ovo je API jezika ECMAScript, a ne web-API preglednika; sam standard ne potvrđuje podršku u određenom pregledniku.

Primjeri

"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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori