CKTIS / JavaScript
Reflect.preventExtensions — impedire l’estensione di un oggetto
Reflect.preventExtensions(target) impedisce di aggiungere nuove proprietà proprie a un oggetto e restituisce un valore booleano. Non congela le proprietà esistenti e può comunque generare eccezioni.
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
Reflect.preventExtensions(target)Reflect.preventExtensions(target) invoca l’operazione interna [[PreventExtensions]] dell’oggetto. Restituisce true se l’operazione riesce o false se viene rifiutata. L’argomento deve essere un oggetto; un valore primitivo, compreso null, causa un TypeError. Le eccezioni dell’operazione interna vengono propagate: un risultato booleano non significa che le eccezioni siano impossibili.
Per un oggetto ordinario, il successo impedisce in modo permanente di aggiungere nuove proprietà proprie, comprese quelle con chiavi di tipo Symbol. Una chiamata successiva restituisce true. Non è possibile neanche cambiare il prototipo con uno diverso. Le proprietà esistenti possono ancora essere modificate o eliminate se i loro descrittori lo consentono; gli oggetti annidati non vengono modificati.
Non equivale a Object.seal o Object.freeze: il metodo non modifica gli attributi configurable né writable. Object.preventExtensions restituisce il proprio argomento in caso di successo e genera un TypeError se l’operazione restituisce false; restituisce invariati i valori primitivi. Reflect.preventExtensions, invece, espone il risultato booleano e rifiuta i valori primitivi.
Un Proxy può intercettare l’operazione tramite la trappola preventExtensions. La trappola può rifiutarla restituendo false, ma dichiarare il successo mentre il target è ancora estensibile causa un TypeError. Nell’esempio, Reflect.set mostra un tentativo non riuscito di aggiungere una proprietà senza dipendere dalla modalità strict.
Esempi
const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));Risultato
true false false 2 true 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.