proxy-freeze

Simple way to freeze JavaScript objects and know of attempted modifications

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
proxy-freeze
411.0.06 years ago6 years agoMinified + gzip package size for proxy-freeze in KB

Readme

proxy-freeze
!npmnpm-imagenpm-url !travistravis-imagetravis-url !standardstandard-imagestandard-url
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