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.