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

CKTIS / JavaScript

Object.seal — sceller un objet

Object.seal empêche l’ajout et la suppression des propriétés propres d’un objet, sans le rendre immuable. Sur un objet ordinaire, les propriétés de données accessibles en écriture peuvent toujours recevoir de nouvelles valeurs, et les objets imbriqués ne sont pas scellés automatiquement.

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.seal(obj)

Object.seal(obj) modifie l’objet fourni et renvoie ce même objet, sans en créer de copie. La méthode empêche son extension et définit configurable: false pour toutes ses propriétés propres, y compris celles qui ne sont pas énumérables et celles dont la clé est un symbole. Il n’est alors plus possible d’ajouter ou de supprimer des propriétés propres, de modifier leur énumérabilité, ni de convertir des propriétés de données en accesseurs ou inversement.

Sceller un objet ne le rend pas immuable. Sur un objet ordinaire, les propriétés de données existantes avec writable: true peuvent toujours recevoir de nouvelles valeurs, et il est possible de faire passer writable de true à false, mais pas l’inverse. Dans un objet d’espace de noms de module scellé, les descripteurs des propriétés correspondant aux exportations indiquent writable: true, mais l’objet refuse aussi bien les affectations à ces propriétés que les tentatives de passer leur attribut writable à false. Les setters existants peuvent toujours fonctionner. L’opération est superficielle : les objets imbriqués ne sont pas scellés automatiquement.

Object.preventExtensions empêche l’ajout de propriétés propres, mais ne rend pas à lui seul les propriétés existantes non configurables. Sur un objet ordinaire, Object.freeze définit en plus writable: false pour les propriétés de données propres ; cette opération est également superficielle. Vérifiez le scellement avec Object.isSealed.

En mode strict, une affectation interdite à une nouvelle propriété ou la suppression d’une propriété existante avec delete déclenche une TypeError ; hors du mode strict, ces opérations échouent généralement sans lever d’exception. Object.seal peut lever une exception si le scellement échoue, par exemple avec certains objets Proxy. En ECMAScript moderne, un argument qui n’est pas un objet est renvoyé inchangé.

Exemples

"use strict";

const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;

console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);

try {
  settings.extra = 1;
} catch (error) {
  console.log(error instanceof TypeError);
}

console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));

Résultat

true
true
3 true
true
false
false

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