Merge pull request #2 from ambit-tsai/dev

v2.0.0

Author: ambit-tsai

README.md

@@ -1,49 +1,57 @@
-English | <a href="README.zh-CN.md">中文</a>
+[简体中文](README.zh-CN.md) | English
 
-# 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. 
+# ES6 Proxy Polyfill&nbsp;&nbsp;![Version](https://img.shields.io/npm/v/es6-proxy-polyfill.svg)
 
-Due to the limitations of ES3, the polyfill supports just a limited number of proxy 'traps':
+This is a polyfill for ES6 `Proxy`, supports  **IE6+** , Node.js, etc.
+
+So far, it supports more features than the <a href="https://github.com/GoogleChrome/proxy-polyfill" target="_blank">proxy-polyfill</a> of GoogleChrome.
+
+The polyfill supports just a limited number of proxy 'traps':
+* get
+* set
 * apply
 * construct
 
 The `Proxy.revocable` method is also supported, but only for calls to the above traps.
 
-#### Installation
 
+#### Installation
 1. Use NPM: `npm install -S 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:
-```
+```html
+<!--[if lte IE 8]>
+<script src="path/to/object-defineproperty-ie.js" type="text/javascript"></script>
+<![endif]-->
 <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);
+    var proxy = new Proxy({}, {});
 </script>
 ```
 2. Node.js:
-```
-require('es6-proxy-polyfill');
+```javascript
+const Proxy = require('es6-proxy-polyfill');
 
-var target = function(){/* code */};
-var handler = {/* code */};
-var proxy = new Proxy(target, handler);
+let proxy = new Proxy({}, {});
 ```
 
 
 #### Notice
+1. For **non-array** object, the properties you want to proxy **must be known at creation time**;
+1. In IE8 or below, `Object.defineProperties` and `Object.getOwnPropertyDescriptor` are provided by library "<a href="https://github.com/ambit-tsai/object-defineproperty-ie" target="_blank">object-defineproperty-ie</a>";
+1. Support `UMD`.
 
-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;
-3. The revoked `Proxy` object will not throw errors when it's properties are accessed.
+
+#### Testing
+1. Access `test/browser/index.html` with browser
+1. Tested in IE6-8, IE11
+
+
+#### Contact Us
+1. WeChat: ambit_tsai
+1. QQ Group: 663286147
+1. E-mail: [email protected]

README.zh-CN.md

@@ -1,49 +1,57 @@
-<a href="README.md">English</a> | 中文
+简体中文 | [English](README.md)
 
-# ES6 Proxy Polyfill
-这是一个基于 **ES3** 的`Proxy`构造器polyfill，支持 **IE8** 和 Node.js 等。
 
-参照 <a href="https://tc39.github.io/ecma262/#sec-proxy-target-handler" target="_blank">ECMAScript</a> 标准编写，无外部依赖。
+# ES6 Proxy Polyfill&nbsp;&nbsp;![Version](https://img.shields.io/npm/v/es6-proxy-polyfill.svg)
 
-由于ES3的限制，该polyfill只支持有限的'traps'代理：
+一个 ES6 `Proxy` 的兼容库，支持 **IE6+** 和 Node.js 等。
+
+迄今为止，它支持比 GoogleChrome <a href="https://github.com/GoogleChrome/proxy-polyfill" target="_blank">proxy-polyfill</a> 更多的特性。
+
+该 polyfill 只支持有限的 'trap' 代理：
+* get
+* set
 * apply
 * construct
 
-`Proxy.revocable`方法也被支持，但只限于调用上面的'traps'。
+`Proxy.revocable` 方法也被支持，但只限于调用上面的 'trap' 。
 
-#### 安装
 
+#### 安装
 1. 使用NPM：`npm install -S 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. 浏览器：
-```
+```html
+<!--[if lte IE 8]>
+<script src="path/to/object-defineproperty-ie.js" type="text/javascript"></script>
+<![endif]-->
 <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);
+    var proxy = new Proxy({}, {});
 </script>
 ```
 2. Node.js：
-```
-require('es6-proxy-polyfill');
+```javascript
+var Proxy = require('es6-proxy-polyfill');
 
-var target = function(){/* code */};
-var handler = {/* code */};
-var proxy = new Proxy(target, handler);
+var proxy = new Proxy({}, {});
 ```
 
 
 #### 注意
+1. 对于**非数组**对象，想要代理的属性**必须在创建时就已存在**；
+1. 在 IE8 及以下，`Object.defineProperties` 与 `Object.getOwnPropertyDescriptor` 由 "<a href="https://github.com/ambit-tsai/object-defineproperty-ie" target="_blank">object-defineproperty-ie</a>" 库提供支持；
+1. 支持 `UMD`。
 
-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 测试过，而且它也应该能够运行在其他环境下；
-3. 当自身属性被访问时，被撤销的`Proxy`对象不会抛出错误。
+
+#### 测试
+1. 使用浏览器访问 `test/browser/index.html`
+1. 已在 IE6-8、IE11 中进行测试
+
+
+#### 联系
+1. 微信: ambit_tsai
+1. QQ群: 663286147
+1. 邮箱: [email protected]

dist/es6-proxy-polyfill.js

@@ -1,23 +1,21 @@
 {
   "name": "es6-proxy-polyfill",
-  "version": "1.2.1",
+  "version": "2.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 -o dist/es6-proxy-polyfill.js"
+    "build": "uglifyjs src/es6-proxy-polyfill.js -c -m --ie8 --comments -o dist/es6-proxy-polyfill.js"
   },
   "keywords": [
     "proxy",
     "es6-proxy",
     "proxy-polyfill",
-    "ie8",
-    "Proxy",
-    "ES6-Proxy",
-    "IE8"
+    "polyfill",
+    "ie8"
   ],
   "author": "[email protected]",
   "license": "Apache-2.0",
-	"repository": {
+  "repository": {
     "type": "git",
     "url": "git+https://github.com/ambit-tsai/es6-proxy-polyfill.git"
   },