Object.preventExtensions()

Object.preventExtensions(obj) 

obj

O objeto a tornar-se não-extensível.

Um objeto tornado não-extensível.

Um objeto é extensível se novas propriedades puderem der adicionadas ao mesmo. Object.preventExtensions() marca um objeto como não mais extensível, de forma que este nunca terá novas propriedades além daquelas que o objeto tinha quando foi marcado como não-extensível. Note que as propriedades de um objeto não-extensível, em geral, ainda poderão ser apagadas. Tentativas de adicionar novas propriedades a um objeto não-extensível falharão, tanto silenciosamente ou lançando uma exceção TypeError (mais comumente, mas não exclusivamente, quando em strict mode).

Object.preventExtensions() evita apenas a adição de novas propriedades diretas. Proprieades ainda poderão ser adicionadas ao protótipo do objeto.

É impossível tornar um objeto extensível novamente uma vez que o mesmo tenha se tornado não-extensível.

// Object.preventExtensions retorna o objeto // tornado não-extensível. var obj = {}; var obj2 = Object.preventExtensions(obj); obj === obj2; // verdadeiro // Objetos são extensíveis por padrão... var empty = {}; Object.isExtensible(empty); // === verdadeiro // ...mas isso pode ser mudado. Object.preventExtensions(empty); Object.isExtensible(empty); // === falso // Object.defineProperty lança erro quando adiciona-se // uma nova propriedade a um objeto não-extensível. var nonExtensible = { removable: true }; Object.preventExtensions(nonExtensible); Object.defineProperty(nonExtensible, "new", { value: 8675309, }); // lança um TypeError // No modo restrito, tentar adicionar novas propriedades a // um objeto não-extensível lança um TypeError. function fail() { "use strict"; // lança um TypeError nonExtensible.newProperty = "FAIL"; } fail(); 

O protótipo não-extensível de um objeto é imutável:

var fixed = Object.preventExtensions({}); // lança um 'TypeError'. fixed.__proto__ = { oh: "hai" }; 

No ES5, se o argumento atribuído a este método não for um objeto (for um primitivo), isso causará um erro de tipo TypeError. No ES2015, um argumento não-objeto será tratado como se o mesmo fosse um objeto não-extensível comum, simplesmente retornando-o.

Object.preventExtensions(1); // TypeError: 1 não é um objeto (código ES5) Object.preventExtensions(1); // 1 (código ES2015) 

• Object.isExtensible()
• Object.seal()
• Object.isSealed()
• Object.freeze()
• Object.isFrozen()
• Reflect.preventExtensions()