CKTIS / JavaScript
Object.preventExtensions — empêcher l’ajout de propriétés
Object.preventExtensions(obj) empêche de façon irréversible l’ajout de propriétés propres à un objet et renvoie ce même objet. Cela ne fige ni les valeurs existantes ni 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.preventExtensions(obj)Object.preventExtensions(obj) rend un objet non extensible : aucune nouvelle propriété propre ne peut être ajoutée, y compris avec des clés de type symbol. La méthode modifie l’objet fourni et renvoie la même référence, pas une copie. Utilisez Object.isExtensible(obj) pour vérifier son état. Cette opération est irréversible.
Dans un objet ordinaire, les propriétés existantes conservent leurs descripteurs : il reste possible d’affecter une valeur aux propriétés accessibles en écriture et de supprimer les propriétés configurables. Une propriété supprimée ne peut pas être ajoutée de nouveau. Il est également interdit de remplacer le prototype par un autre ; indiquer le prototype actuel reste autorisé.
Un tableau typé de longueur fixe qui repose sur un ArrayBuffer non redimensionnable peut être rendu non extensible, mais ses éléments indexés existants ne peuvent pas être supprimés, même si leurs descripteurs indiquent configurable: true.
Une affectation qui créerait une nouvelle propriété propre déclenche une TypeError en mode strict et est généralement ignorée hors de ce mode. Object.defineProperty déclenche une TypeError lorsqu’on lui demande d’ajouter une propriété, quel que soit le mode. La méthode elle-même déclenche aussi une TypeError si l’opération interne refuse d’empêcher l’extension, par exemple à cause d’un piège de Proxy qui renvoie false. Dans ECMAScript actuel, les arguments primitifs, y compris null et undefined, sont renvoyés sans modification.
Object.seal offre une protection plus forte : la méthode définit configurable à false pour toutes les propriétés propres, ce qui empêche leur suppression. Dans un objet ordinaire scellé, l’attribut writable d’une propriété de données accessible en écriture peut encore passer de true à false. Un objet d’espace de noms de module scellé indique writable: true dans les descripteurs des propriétés qui correspondent aux liaisons exportées, mais refuse de définir cet attribut à false. Pour un objet ordinaire, Object.freeze définit en plus writable à false pour toutes les propriétés de données propres à l’objet. Sur un objet d’espace de noms de module, Object.freeze déclenche une TypeError lorsqu’il tente de définir writable à false pour une propriété correspondant à une liaison exportée. Si cette liaison n’est pas encore initialisée, la récupération du descripteur de la propriété peut déclencher une ReferenceError avant cette tentative. Aucune de ces opérations n’agit de façon récursive sur les objets imbriqués. Il s’agit d’une API du langage ECMAScript, et non d’une API Web de navigateur ; la norme seule ne permet pas d’établir sa prise en charge dans un navigateur particulier.
Exemples
"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
item.extra = 3;
} catch (error) {
console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));Résultat
true false 2 true TypeError 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.