CKTIS / JavaScript
Object.isSealed — vérifier si un objet est scellé
Object.isSealed(value) vérifie si un objet n’est pas extensible et si toutes ses propriétés propres sont non configurables. Cela ne signifie ni que les valeurs sont immuables ni que les objets imbriqués sont scellés.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.isSealed(value)Object.isSealed(value) renvoie true lorsque l’objet n’est pas extensible et que chacune de ses propriétés propres a configurable: false. La vérification inclut les propriétés non énumérables et les clés Symbol, mais pas les propriétés héritées. Elle examine l’état ; contrairement à Object.seal, elle n’impose pas ces restrictions.
Le scellement empêche l’ajout et la suppression de propriétés propres, ainsi que les modifications interdites par leur caractère non configurable. Le scellement ne modifie pas en lui-même l’attribut writable. Sur un objet ordinaire, on peut toujours affecter une nouvelle valeur à une propriété de données propre et inscriptible. Sur les objets exotiques, en revanche, writable: true ne garantit pas qu’une affectation réussisse. Par exemple, un objet d’espace de noms de module scellé indique writable: true pour ses liaisons exportées, mais rejette les affectations à ces liaisons. Object.isFrozen exige en plus que les propriétés de données propres ne soient pas inscriptibles. Aucune de ces vérifications n’est récursive.
Object.preventExtensions seul ne suffit généralement pas si des propriétés configurables subsistent. Toutefois, un objet vide non extensible est scellé. Dans ECMAScript actuel, les arguments primitifs, y compris null et undefined, renvoient true ; cela ne signifie pas qu’il s’agit d’objets.
Avec un Proxy, la vérification peut invoquer des pièges et déclencher une exception ; elle n’est donc pas toujours une inspection sans effet de bord. Il s’agit d’une API du langage ECMAScript, et non d’une API Web de navigateur ; la spécification du langage n’est pas un tableau de compatibilité des navigateurs.
Exemples
const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));Résultat
false true false 2 false true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.