Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.seal — sigillare un oggetto

Object.seal impedisce di aggiungere ed eliminare le proprietà proprie di un oggetto, ma non lo rende immutabile. In un oggetto ordinario, le proprietà dati scrivibili possono ancora ricevere nuovi valori e gli oggetti annidati non vengono sigillati automaticamente.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

Object.seal(obj)

Object.seal(obj) modifica l’oggetto fornito e restituisce lo stesso oggetto, senza crearne una copia. Ne impedisce l’estensione e imposta configurable: false su tutte le proprietà proprie, comprese quelle non enumerabili e quelle con chiave Symbol. In seguito non è possibile aggiungere o eliminare proprietà proprie, modificarne l’enumerabilità né convertire proprietà dati in accessor o viceversa.

Sigillare non significa rendere immutabile. In un oggetto ordinario, le proprietà dati esistenti con writable: true possono ancora ricevere nuovi valori ed è possibile modificare writable da true a false, ma non viceversa. In un oggetto namespace di modulo sigillato, i descrittori delle proprietà corrispondenti alle esportazioni riportano writable: true, ma l’oggetto rifiuta sia le assegnazioni a tali proprietà sia i tentativi di impostarne l’attributo writable su false. I setter esistenti possono continuare a funzionare. L’operazione è superficiale: gli oggetti annidati non vengono sigillati automaticamente.

Object.preventExtensions impedisce di aggiungere proprietà proprie, ma da solo non rende non configurabili quelle esistenti. In un oggetto ordinario, Object.freeze imposta inoltre writable: false sulle proprietà dati proprie; anche questa operazione è superficiale. Verifica lo stato di sigillatura con Object.isSealed.

In modalità strict, un’assegnazione non consentita a una nuova proprietà o l’eliminazione di una proprietà esistente con delete genera un TypeError; fuori dalla modalità strict, queste operazioni in genere falliscono senza generare eccezioni. Object.seal può generare un’eccezione se la sigillatura non riesce, per esempio con alcuni oggetti Proxy. In ECMAScript moderno, un argomento che non è un oggetto viene restituito senza modifiche.

Esempi

"use strict";

const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;

console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);

try {
  settings.extra = 1;
} catch (error) {
  console.log(error instanceof TypeError);
}

console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));

Risultato

true
true
3 true
true
false
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti