CKTIS / JavaScript
Object.isFrozen — vérifier si un objet est figé
Object.isFrozen(value) vérifie si un objet n’est pas extensible, si ses propriétés propres ne sont pas configurables et si ses propriétés de données ne sont pas modifiables. La méthode ne fige pas l’objet et ne vérifie pas récursivement les objets imbriqué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.isFrozen(value)Object.isFrozen(value) est une méthode statique qui renvoie true lorsqu’un objet ne peut pas recevoir de propriétés propres, que toutes ses propriétés propres ont configurable: false et que ses propriétés propres de données ont également writable: false. Les clés symboliques et les propriétés non énumérables sont prises en compte, mais pas les propriétés héritées.
La méthode examine l’état de l’objet au lieu de le modifier ; utilisez Object.freeze pour le figer. Object.seal ne suffit pas si des propriétés de données modifiables subsistent. En revanche, un objet vide est figé après Object.preventExtensions, puisqu’il ne possède aucune propriété qui enfreigne les autres conditions.
Un résultat true ne signifie pas que l’objet est profondément immuable. Les objets stockés comme valeurs de propriétés peuvent encore changer. Les propriétés d’accesseur peuvent conserver des setters, et les getters peuvent renvoyer des résultats variables ; le test n’exige pas leur suppression et n’appelle pas les getters d’un objet ordinaire.
Pour les valeurs primitives, y compris null et undefined, la spécification actuelle renvoie true. Avec un Proxy, l’inspection peut déclencher des pièges et lever une exception : l’opération n’est donc pas toujours sans effet de bord.
Exemples
const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));Résultat
false true false true 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.