Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources