Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Reflect.isExtensible — verificare l’estensibilità di un oggetto

Reflect.isExtensible(target) verifica se un oggetto è estensibile. Per un oggetto ordinario, l’estensibilità significa che è possibile aggiungervi nuove proprietà proprie. Il metodo restituisce un booleano e genera un TypeError per i valori primitivi.

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.isExtensible(target)

Reflect.isExtensible(target) restituisce true se un oggetto è estensibile e false se non lo è. Per un oggetto ordinario, l’estensibilità significa che è possibile aggiungere nuove proprietà proprie. Il metodo legge questo stato, ma non lo modifica direttamente.

Object.preventExtensions(target) impedisce di aggiungere nuove proprietà proprie. Anche Object.seal(target) e Object.freeze(target) rendono gli oggetti non estensibili, ma impongono ulteriori restrizioni. Quindi, false non significa che l’oggetto sia congelato: le proprietà esistenti scrivibili possono ancora essere modificate e quelle configurabili possono ancora essere eliminate. Un oggetto ordinario non può tornare a essere estensibile.

L’argomento deve essere un oggetto; anche gli array e le funzioni sono oggetti. I valori primitivi, inclusi null e undefined, causano un TypeError. Questa è una differenza importante rispetto a Object.isExtensible(target), che restituisce false per i primitivi invece di generare un’eccezione.

Il metodo richiama l’operazione interna [[IsExtensible]]. Con un Proxy può essere invocata la trap isExtensible, quindi non presumere che l’operazione sia priva di effetti collaterali. Dopo la conversione in booleano, il risultato della trap deve corrispondere all’effettiva estensibilità dell’oggetto di destinazione; altrimenti si verifica un TypeError. Anche un proxy revocato causa un TypeError.

Esempi

const item = { count: 1 };
console.log(Reflect.isExtensible(item));

Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));

item.count = 2;
console.log(item.count);

try {
  Reflect.isExtensible(42);
} catch (error) {
  console.log(error.name);
}

Risultato

true
false
false
2
TypeError

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