Upload project files

Upload project files

Author: ambit-tsai

LICENSE

@@ -1,2 +1,47 @@
-# es6-proxy-polyfill
-Proxy polyfill based on ES3 supports IE8, Node.js, etc.
+<div align="right">[ <a href="README_zh.md">中文</a> ]</div>
+
+# ES6 Proxy Polyfill
+This is a polyfill for the `Proxy` constructor based on  **ES3**  supports  **IE8** , Node.js, etc.
+
+Refer to <a href="https://tc39.github.io/ecma262/#sec-proxy-target-handler" target="_blank">ECMAScript</a>, and this has no external dependencies. 
+
+Due to the limitations of ES3, the polyfill supports just a limited number of proxy 'traps':
+* apply
+* construct
+
+
+#### Installation
+
+1. Use NPM: `npm install es6-proxy-polyfill`
+2. Download directly: <a href="src/es6-proxy-polyfill.js" target="_blank">Development Version</a>, <a href="dist/es6-proxy-polyfill.js" target="_blank">Production Version</a>
+
+
+#### Usage
+
+1. Browser:
+```
+<script src="path/to/es6-proxy-polyfill.js" type="text/javascript"></script>
+<script type="text/javascript">
+    var target = function(){/* code */};
+    var handler = {/* code */};
+    var proxy = new Proxy(target, handler);
+</script>
+```
+2. Node.js:
+```
+require('es6-proxy-polyfill');
+
+var target = function(){/* code */};
+var handler = {/* code */};
+var proxy = new Proxy(target, handler);
+```
+
+
+#### Notice
+
+1. In ES6, the access to `Proxy` object's properties will be passed to target. In order to simulate this feature, polyfill will try to copy properties from target by using `Object.assign` method, so it's better to load an `Object.assign` polyfill first;
+```
+<script src="path/to/babel-polyfill.js" type="text/javascript"></script>
+<script src="path/to/es6-proxy-polyfill.js" type="text/javascript"></script>
+```
+2. The code has been tested on Node.js 0.10.48 and IE8, and it may work in other environments too.

README.md

@@ -0,0 +1,47 @@
+<div align="right">[ <a href="README.md">English</a> ]</div>
+
+# ES6 Proxy Polyfill
+这是一个基于 **ES3** 的`Proxy`构造器polyfill，支持 **IE8** 和 Node.js 等。
+
+参照 <a href="https://tc39.github.io/ecma262/#sec-proxy-target-handler" target="_blank">ECMAScript</a> 标准编写，无外部依赖。
+
+由于ES3的限制，该polyfill只支持有限的'traps'代理：
+* apply
+* construct
+
+
+#### 安装
+
+1. 使用NPM：`npm install es6-proxy-polyfill`
+2. 直接下载：<a href="src/es6-proxy-polyfill.js" target="_blank">开发版本</a>，<a href="dist/es6-proxy-polyfill.js" target="_blank">生产版本</a>
+
+
+#### 用法
+
+1. 浏览器：
+```
+<script src="path/to/es6-proxy-polyfill.js" type="text/javascript"></script>
+<script type="text/javascript">
+    var target = function(){/* code */};
+    var handler = {/* code */};
+    var proxy = new Proxy(target, handler);
+</script>
+```
+2. Node.js：
+```
+require('es6-proxy-polyfill');
+
+var target = function(){/* code */};
+var handler = {/* code */};
+var proxy = new Proxy(target, handler);
+```
+
+
+#### 注意
+
+1. 在ES6中，对`Proxy`对象属性的访问将会被传递给目标对象。为了模拟这个特性，polyfill会尝试使用`Object.assign`方法从目标对象复制属性，因此最好先加载一个`Object.assign`的polyfill；
+```
+<script src="path/to/babel-polyfill.js" type="text/javascript"></script>
+<script src="path/to/es6-proxy-polyfill.js" type="text/javascript"></script>
+```
+2. 代码已经在Node.js 0.10.48 和 IE8 测试过，而且它也应该能够运行在其他环境下。

README_zh.md

@@ -0,0 +1,25 @@
+{
+  "name": "es6-proxy-polyfill",
+  "version": "1.0.0",
+  "description": "Proxy polyfill based on ES3 supports IE8, Node.js, etc.",
+  "main": "src/es6-proxy-polyfill.js",
+  "scripts": {
+    "build": "uglifyjs src/es6-proxy-polyfill.js -c -m reserved=[Proxy] --ie8 --comments --source-map -o dist/es6-proxy-polyfill.js"
+  },
+  "keywords": [
+    "proxy-polyfill",
+    "proxy",
+    "polyfill",
+    "ie8",
+    "es6"
+  ],
+  "author": "[email protected]",
+  "license": "Apache-2.0",
+	"repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambit-tsai/es6-proxy-polyfill.git"
+  },
+  "devDependencies": {
+    "uglify-js": "^3.4.8"
+  }
+}

dist/es6-proxy-polyfill.js

@@ -0,0 +1,139 @@
+/**
+ * ES6 Proxy Polyfill
+ * @version 1.0.0
+ * @author Ambit Tsai <[email protected]>
+ * @license Apache-2.0
+ * @see {@link https://github.com/ambit-tsai/es6-proxy-polyfill}
+ */
+;(function(global){
+	if(global.Proxy) return;			// return if Proxy already exist
+		
+	var noop = function(){},
+		assign = Object.assign || noop,
+		getProto = Object.getPrototypeOf || noop,
+		setProto = Object.setPrototypeOf || noop;
+	
+	/**
+	 * Throw a type error
+	 * @param {String} message
+	 */
+	function throwTypeError(message){
+		throw new TypeError(message);
+	}
+	
+	/**
+	* The internal member constructor
+	* @constructor
+	* @param {Function} target
+	* @param {Object} handler
+	*/
+	function InternalMember(target, handler){
+		this.target = target;			// [[ProxyTarget]]
+		this.handler = handler;			// [[ProxyHandler]]
+	}
+	
+	/**
+	* The [[Call]] internal method
+	* @param {Object} thisArg
+	* @param {Object} argsList
+	*/
+	InternalMember.prototype.$call = function(thisArg, argsList){
+		var target = this.target,
+			handler = this.handler;
+		if(!handler){
+			throwTypeError("Cannot perform 'call' on a proxy that has been revoked");
+		}
+		if(handler.apply == null){
+			return target.apply(thisArg, argsList);
+		}else if(typeof handler.apply === 'function'){
+			return handler.apply(target, thisArg, argsList);
+		}else{
+			throwTypeError('Proxy handler\'s apply trap must be a function');
+		}
+	};
+	
+	/**
+	* The [[Construct]] internal method
+	* @param {Object} thisArg
+	* @param {Object} argsList
+	* @returns {Object}
+	*/
+	InternalMember.prototype.$construct = function(thisArg, argsList){
+		var target = this.target,
+			handler = this.handler,
+			obj;
+		if(!handler){
+			throwTypeError("Cannot perform 'construct' on a proxy that has been revoked");
+		}
+		if(handler.construct == null){
+			obj = target.apply(thisArg, argsList);
+			if(obj instanceof Object){
+				return obj;
+			}else{
+				return thisArg;
+			}
+		}else if(typeof handler.construct === 'function'){
+			obj = handler.construct(target, argsList);
+			if(obj instanceof Object){
+				return obj;
+			}else{
+				throwTypeError('Proxy handler\'s construct trap must return an object');
+			}
+		}else{
+			throwTypeError('Proxy handler\'s construct trap must be a function');
+		}
+	};
+
+	/**
+	 * Create a Proxy object
+	 * @param {Function} target
+	 * @param {Object} handler
+	 * @returns {Function}
+	 */
+	function createProxy(target, handler){
+		// Check the type of arguments
+		if(typeof target !== 'function'){
+			throwTypeError('Proxy polyfill only support function target');
+		}else if( !(handler instanceof Object) ){
+			throwTypeError('Cannot create proxy with a non-object handler');
+		}
+		
+		// The internal member
+		var member = new InternalMember(target, handler);
+		
+		// The Proxy object
+		function P(){
+			return this instanceof P?
+				member.$construct(this, arguments):
+				member.$call(this, arguments);
+		}
+		
+		assign(P, target);           	// copy target's properties
+		P.prototype = target.prototype;	// copy target's prototype
+		setProto(P, getProto(target));	// copy target's [[Prototype]]
+		
+		return P;
+	}
+	
+	/**
+	 * The Proxy constructor
+	 * @constructor
+	 * @param {Function} target
+	 * @param {Object} handler
+	 * @returns {Function}
+	 */
+	function Proxy(target, handler){
+		if(this instanceof Proxy){
+			return createProxy(target, handler);
+		}else{
+			throwTypeError("Constructor Proxy requires 'new'");
+		}
+	}
+	
+	// Prevent function declaration from being translated into function expression by UglifyJS.
+	// Function expression called by 'new' will cause an inconsistent result between old IE and
+	// others when runing the code - `this instanceof P`.
+	Proxy.revocable;
+	
+	global.Proxy = Proxy;
+}(typeof window==='object'? window: global));

dist/es6-proxy-polyfill.js.map

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta http-equiv="content-type" content="text/html;charset=utf-8">
+	<title>trap-apply</title>
+</head>
+<body>
+	<script src="../../dist/es6-proxy-polyfill.js" type="text/javascript"></script>
+	<script type="text/javascript">
+		var person = {
+			name: "Ambit_Tsai",
+			sayHello: function(){
+				document.write(">"+this.name+": Hey man!<br>");
+			}
+		};
+		
+		person.sayHello = new Proxy(person.sayHello, {
+			apply: function(func, ctx, args){
+				document.write("Trigger 'apply' trap<br>");
+				func.apply(ctx, args);
+			}
+		});
+		
+		document.write("Call 'sayHello' method<br>");
+		person.sayHello();
+	</script>
+</body>
+</html>

package.json

@@ -0,0 +1,35 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta http-equiv="content-type" content="text/html;charset=utf-8">
+	<title>trap-construct</title>
+</head>
+<body>
+	<script src="../../dist/es6-proxy-polyfill.js" type="text/javascript"></script>
+	<script type="text/javascript">
+		function Person(name){
+			document.write("Set this.name to '"+name+"'<br>");
+			this.name = name;
+		}
+		Person.prototype.sayHello = function(){
+			document.write(">"+this.name+": Hey man!<br>");
+		};
+		Person.className = "Person";
+		
+		var NewPerson = new Proxy(Person, {
+			construct: function(Target, args){
+				document.write("Trigger 'construct' trap<br>");
+				return new Target(args[0]);
+			}
+		});
+		
+		document.write("NewPerson's className: '"+NewPerson.className+"' (need 'Object.assign')<br>");
+		
+		document.write("Create a NewPerson object<br>");
+		var person = new NewPerson("Ambit_Tsai");
+		
+		document.write("Call 'sayHello' method<br>");
+		person.sayHello();
+	</script>
+</body>
+</html>

src/es6-proxy-polyfill.js

@@ -0,0 +1,17 @@
+require('../../src/es6-proxy-polyfill');
+
+var person = {
+	name: "Ambit_Tsai",
+	sayHello: function(){
+		console.log(">"+this.name+": Hey man!");
+	}
+};
+person.sayHello = new Proxy(person.sayHello, {
+	apply: function(func, ctx, args){
+		console.log("Trigger 'apply' trap");
+		func.apply(ctx, args);
+	}
+});
+
+console.log("Call 'sayHello' method");
+person.sayHello();