JavaScript Object.freeze()

Définition et utilisation

Object.freeze() La méthode est utilisée pour empêcher toute modification de l'objet.

Dans le mode non strict,Object.freeze() La méthode échoue silencieusement.

Dans le mode strict,Object.freeze() La méthode lève une erreur TypeError.

Les objets gelés sont ne sont pas modifiables. Il n'est pas autorisé de modifier, d'ajouter ou de supprimer des propriétés.

Il peut être utilisé Object.isFrozen() Méthodes pour vérifier si un objet est gelé.

Méthodes associées :

Object.preventExtensions() Autorise la modification, mais empêche l'ajout de propriétés.

Object.seal() Permet la modification, mais empêche l'ajout et la suppression de propriétés.

Object.freeze() Empêche la modification, l'ajout et la suppression de propriétés.

Object.isExtensible() Retourne true si l'objet est extensible.

Object.isSealed() Retourne true si l'objet est scellé.

Object.isFrozen() Retourne true si l'objet est figé.

Instance

Exemple 1

"use strict"
// Créer un objet
const person = {
  firstName: "Bill",
  lastName: "Gates",
  age: 50,
  eyeColor: "blue"
};
// Figer l'objet
Object.freeze(person);
// Cela lancera une erreur
person.age = 51;

Essayer par vous-même

Exemple 2

const fruits = ["Banane", "Orange", "Apple", "Mangue"];
Object.freeze(fruits);
// Cela lancera une erreur :
fruits.push("Kiwi");

Essayer par vous-même

Syntaxe

Object.freeze(object)

Paramètre

Paramètre Description
object Requis. Objet à figer.

Valeur de retour

Type Description
Object Objet figé.

Support du navigateur

Object.freeze() C'est une caractéristique de ECMAScript5 (ES5).

Depuis juillet 2013, tous les navigateurs modernes prennent en charge complètement ES5 (JavaScript 2009) :

Chrome Edge Firefox Safari Opera
Chrome 23 IE/Edge 11 Firefox 21 Safari 6 Opera 15
Septembre 2012 Septembre 2012 Avril 2013 Juillet 2012 Juillet 2013