babel-plugin-proxy
v1.1.0
Published
Use ES2015 proxies today!
Downloads
2,357
Readme
babel-plugin-proxy
Use ES6 proxies today!
Installation
npm install babel-plugin-proxy --save-dev
Motivation
Proxies are awesome feature of ES2015 that enables redefining some language operations. For example we can intercept every object property access with our own function.
The problem is that proper proxy implementation requires native browser support (currently it works in Firefox and Edge). This plugin is proof of concept that proxies can be implemented with ES5 features. It is not suitable for production environments because performance impact is huge.
How does it work?
We are intercepting every property access (except these connected with function invocation) and property assignment with custom interceptor functions that performs runtime check if object is proxied.
proxy.foo = 5;
proxy.foo;
becomes:
globalSetInterceptor(proxy, "foo", 5);
globalGetInterceptor(proxy, 'foo');
These interceptors performs runtime check if object should be proxied. You can check out whole runtime here
Example
Proxies for example allow us to create objects that will warn us when undefined
key is being accessed.
var proxy = new Proxy({}, {
get: function(target, propKey) {
if (!(propKey in target)) {
console.log("Accessing undefined key!");
}
return target[propKey];
}
});
proxy.a = 5;
console.log(proxy.a);
console.log(proxy.b);
output:
5
Accessing undefined key!
undefined