bpp

babel-plugin-proxy

Use ES6 proxies today!

Showing:

Popularity

Downloads/wk

162

GitHub Stars

61

Maintenance

Last Commit

5yrs ago

Contributors

1

Package

Dependencies

5

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

babel-plugin-proxy

JavaScript Style Guide

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial