JavaScript Object.freeze()
Example
"use strict"
// Create Object
const person = {
firstName: "John",
lastName: "Doe",
age: 50,
eyeColor: "blue"
};
// Freeze Object
Object.freeze(person)
// This will throw an error
person.age = 51;
Try it Yourself »
More Examples Below !
Description
The Object.freeze()
method prevents any changes to an object.
The Object.freeze()
method will fail silently in non-strict mode.
The Object.freeze()
method will throw a TypeError in strict mode.
Frozen objects are read-only. No modification, addition or deletion of properties are allowed.
The Object.isFrozen()
method can be used to check if an object is frozen.
Related Methods:
Object.preventExtensions() allows modifications, but prevents addition of properties.
Object.seal() allows modifications, but prevents additions and deletions of properties.
Object.freeze() prevents modifications, additions and deletions of properties.
Object.isExtensible() returns true if an object is extensible.
Object.isSealed() returns true if an object is sealed.
Object.isFrozen() returns true if an object is frozen.
Syntax
Object.freeze(object)
Parameters
Parameter | Description |
object | Required. The object to freeze. |
Return Value
Type | Description |
Object | The frozen object. |
More Examples
Example
const fruits = ["Banana", "Orange", "Apple", "Mango"];
Object.freeze(fruits);
// This will trow an error:
fruits.push("Kiwi");
Try it Yourself »
Browser Support
Object.freeze()
is an ECMAScript5 (ES5) feature.
ES5 (JavaScript 2009) is fully supported in all modern browsers since July 2013:
Chrome 23 |
IE/Edge 11 |
Firefox 21 |
Safari 6 |
Opera 15 |
Sep 2012 | Sep 2012 | Apr 2013 | Jul 2012 | Jul 2013 |