CKTIS / JavaScript
Object.preventExtensions — impedire nuove proprietà
Object.preventExtensions(obj) impedisce in modo irreversibile di aggiungere proprietà proprie a un oggetto e restituisce lo stesso oggetto. Non congela i valori esistenti né gli oggetti annidati.
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.preventExtensions(obj)Object.preventExtensions(obj) rende un oggetto non estensibile: non è possibile aggiungere nuove proprietà proprie, comprese quelle con chiavi symbol. Il metodo modifica l’oggetto fornito e restituisce lo stesso riferimento, non una copia. Usa Object.isExtensible(obj) per verificarne lo stato. L’operazione non può essere annullata.
In un oggetto ordinario, le proprietà esistenti mantengono i propri descrittori: è ancora possibile assegnare valori alle proprietà scrivibili ed eliminare quelle configurabili. Una proprietà eliminata non può essere aggiunta di nuovo. Non è nemmeno consentito sostituire il prototipo con uno diverso; indicare il prototipo esistente resta consentito.
Un array tipizzato di lunghezza fissa basato su un ArrayBuffer non ridimensionabile può essere reso non estensibile, ma non è possibile eliminare i suoi elementi indicizzati esistenti, anche se i loro descrittori riportano configurable: true.
Un’assegnazione che creerebbe una nuova proprietà propria genera TypeError in modalità strict e di solito viene ignorata al di fuori di tale modalità. Object.defineProperty genera TypeError quando gli si chiede di aggiungere una proprietà, indipendentemente dalla modalità. Anche il metodo stesso genera TypeError se l’operazione interna rifiuta di impedire l’estensione, per esempio a causa di una trappola di Proxy che restituisce false. Nell’ECMAScript attuale, gli argomenti primitivi, inclusi null e undefined, vengono restituiti senza modifiche.
Object.seal offre una protezione maggiore: imposta configurable a false per tutte le proprietà proprie, impedendone l’eliminazione. In un oggetto ordinario sigillato, l’attributo writable di una proprietà dati scrivibile può ancora essere modificato da true a false. Un oggetto sigillato che rappresenta lo spazio dei nomi di un modulo riporta writable: true nei descrittori delle proprietà corrispondenti ai binding esportati, ma non consente di impostare tale attributo a false. In un oggetto ordinario, Object.freeze imposta inoltre writable a false per tutte le proprietà dati proprie dell’oggetto. Su un oggetto che rappresenta lo spazio dei nomi di un modulo, Object.freeze genera TypeError quando tenta di impostare writable a false per una proprietà corrispondente a un binding esportato. Se quel binding non è ancora inizializzato, il recupero del descrittore della proprietà può generare ReferenceError prima di quel tentativo. Nessuna di queste operazioni agisce ricorsivamente sugli oggetti annidati. Questa è un’API del linguaggio ECMAScript, non una Web API del browser; il solo standard non dimostra il supporto in uno specifico browser.
Esempi
"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"));Risultato
true false 2 true TypeError 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.