proxy-freeze

1.0.0 • Public • Published

proxy-freeze

npm travis standard

A simple way to freeze JavaScript objects and know of attempted modifications.

Why?

Why not just use Object.freeze and Object.isFrozen?

If you use Object.freeze and later set a property on that object, it silently fails unless in strict mode. Also, using this technique gives you the ability to listen for warnings on the warning event.

Install

npm install --save proxy-freeze

Usage

proxyFreeze(target)

  • target: can be either an object or constructor function
let obj = {
  name: 'jp'
}
 
let obj2 = proxyFreeze(obj)
obj2.name = 'bob'
 
process.once('warning', (warning) => {
  console.warn(warning.name) // => ProxyFreezeWarning
  console.warn(warning.message) // => Trying to set value of property (name) of frozen object.
  console.warn(warning.stack)
})

License

MIT

Package Sidebar

Install

npm i proxy-freeze

Weekly Downloads

1,523

Version

1.0.0

License

MIT

Last publish

Collaborators

  • jprichardson