docs(proxy): edit defineProperty

docs/proxy.md

@@ -673,7 +673,7 @@ delete proxy._prop
 
 ### defineProperty()
 
-`defineProperty`方法拦截了`Object.defineProperty`操作。
+`defineProperty()`方法拦截了`Object.defineProperty()`操作。
 
 ```javascript
 var handler = {
@@ -686,13 +686,13 @@ var proxy = new Proxy(target, handler);
 proxy.foo = 'bar' // 不会生效
 ```
 
-上面代码中，`defineProperty`方法返回`false`，导致添加新属性总是无效。
+上面代码中，`defineProperty()`方法内部没有任何操作，只返回`false`，导致添加新属性总是无效。注意，这里的`false`只是用来提示操作失败，本身并不能阻止添加新属性。
 
-注意，如果目标对象不可扩展（non-extensible），则`defineProperty`不能增加目标对象上不存在的属性，否则会报错。另外，如果目标对象的某个属性不可写（writable）或不可配置（configurable），则`defineProperty`方法不得改变这两个设置。
+注意，如果目标对象不可扩展（non-extensible），则`defineProperty()`不能增加目标对象上不存在的属性，否则会报错。另外，如果目标对象的某个属性不可写（writable）或不可配置（configurable），则`defineProperty()`方法不得改变这两个设置。
 
 ### getOwnPropertyDescriptor()
 
-`getOwnPropertyDescriptor`方法拦截`Object.getOwnPropertyDescriptor()`，返回一个属性描述对象或者`undefined`。
+`getOwnPropertyDescriptor()`方法拦截`Object.getOwnPropertyDescriptor()`，返回一个属性描述对象或者`undefined`。
 
 ```javascript
 var handler = {
@@ -713,11 +713,11 @@ Object.getOwnPropertyDescriptor(proxy, 'baz')
 // { value: 'tar', writable: true, enumerable: true, configurable: true }
 ```
 
-上面代码中，`handler.getOwnPropertyDescriptor`方法对于第一个字符为下划线的属性名会返回`undefined`。
+上面代码中，`handler.getOwnPropertyDescriptor()`方法对于第一个字符为下划线的属性名会返回`undefined`。
 
 ### getPrototypeOf()
 
-`getPrototypeOf`方法主要用来拦截获取对象原型。具体来说，拦截下面这些操作。
+`getPrototypeOf()`方法主要用来拦截获取对象原型。具体来说，拦截下面这些操作。
 
 - `Object.prototype.__proto__`
 - `Object.prototype.isPrototypeOf()`
@@ -737,13 +737,13 @@ var p = new Proxy({}, {
 Object.getPrototypeOf(p) === proto // true
 ```
 
-上面代码中，`getPrototypeOf`方法拦截`Object.getPrototypeOf()`，返回`proto`对象。
+上面代码中，`getPrototypeOf()`方法拦截`Object.getPrototypeOf()`，返回`proto`对象。
 
-注意，`getPrototypeOf`方法的返回值必须是对象或者`null`，否则报错。另外，如果目标对象不可扩展（non-extensible）， `getPrototypeOf`方法必须返回目标对象的原型对象。
+注意，`getPrototypeOf()`方法的返回值必须是对象或者`null`，否则报错。另外，如果目标对象不可扩展（non-extensible）， `getPrototypeOf()`方法必须返回目标对象的原型对象。
 
 ### isExtensible()
 
-`isExtensible`方法拦截`Object.isExtensible`操作。
+`isExtensible()`方法拦截`Object.isExtensible()`操作。
 
 ```javascript
 var p = new Proxy({}, {
@@ -758,7 +758,7 @@ Object.isExtensible(p)
 // true
 ```
 
-上面代码设置了`isExtensible`方法，在调用`Object.isExtensible`时会输出`called`。
+上面代码设置了`isExtensible()`方法，在调用`Object.isExtensible`时会输出`called`。
 
 注意，该方法只能返回布尔值，否则返回值会被自动转为布尔值。
 
@@ -783,7 +783,7 @@ Object.isExtensible(p)
 
 ### ownKeys()
 
-`ownKeys`方法用来拦截对象自身属性的读取操作。具体来说，拦截以下操作。
+`ownKeys()`方法用来拦截对象自身属性的读取操作。具体来说，拦截以下操作。
 
 - `Object.getOwnPropertyNames()`
 - `Object.getOwnPropertySymbols()`
@@ -835,7 +835,7 @@ for (let key of Object.keys(proxy)) {
 // "baz"
 ```
 
-注意，使用`Object.keys`方法时，有三类属性会被`ownKeys`方法自动过滤，不会返回。
+注意，使用`Object.keys()`方法时，有三类属性会被`ownKeys()`方法自动过滤，不会返回。
 
 - 目标对象上不存在的属性
 - 属性名为 Symbol 值
@@ -868,9 +868,9 @@ Object.keys(proxy)
 // ['a']
 ```
 
-上面代码中，`ownKeys`方法之中，显式返回不存在的属性（`d`）、Symbol 值（`Symbol.for('secret')`）、不可遍历的属性（`key`），结果都被自动过滤掉。
+上面代码中，`ownKeys()`方法之中，显式返回不存在的属性（`d`）、Symbol 值（`Symbol.for('secret')`）、不可遍历的属性（`key`），结果都被自动过滤掉。
 
-`ownKeys`方法还可以拦截`Object.getOwnPropertyNames()`。
+`ownKeys()`方法还可以拦截`Object.getOwnPropertyNames()`。
 
 ```javascript
 var p = new Proxy({}, {
@@ -883,7 +883,7 @@ Object.getOwnPropertyNames(p)
 // [ 'a', 'b', 'c' ]
 ```
 
-`for...in`循环也受到`ownKeys`方法的拦截。
+`for...in`循环也受到`ownKeys()`方法的拦截。
 
 ```javascript
 const obj = { hello: 'world' };
@@ -898,9 +898,9 @@ for (let key in proxy) {
 }
 ```
 
-上面代码中，`ownkeys`指定只返回`a`和`b`属性，由于`obj`没有这两个属性，因此`for...in`循环不会有任何输出。
+上面代码中，`ownkeys()`指定只返回`a`和`b`属性，由于`obj`没有这两个属性，因此`for...in`循环不会有任何输出。
 
-`ownKeys`方法返回的数组成员，只能是字符串或 Symbol 值。如果有其他类型的值，或者返回的根本不是数组，就会报错。
+`ownKeys()`方法返回的数组成员，只能是字符串或 Symbol 值。如果有其他类型的值，或者返回的根本不是数组，就会报错。
 
 ```javascript
 var obj = {};
@@ -915,9 +915,9 @@ Object.getOwnPropertyNames(p)
 // Uncaught TypeError: 123 is not a valid property name
 ```
 
-上面代码中，`ownKeys`方法虽然返回一个数组，但是每一个数组成员都不是字符串或 Symbol 值，因此就报错了。
+上面代码中，`ownKeys()`方法虽然返回一个数组，但是每一个数组成员都不是字符串或 Symbol 值，因此就报错了。
 
-如果目标对象自身包含不可配置的属性，则该属性必须被`ownKeys`方法返回，否则报错。
+如果目标对象自身包含不可配置的属性，则该属性必须被`ownKeys()`方法返回，否则报错。
 
 ```javascript
 var obj = {};
@@ -937,9 +937,9 @@ Object.getOwnPropertyNames(p)
 // Uncaught TypeError: 'ownKeys' on proxy: trap result did not include 'a'
 ```
 
-上面代码中，`obj`对象的`a`属性是不可配置的，这时`ownKeys`方法返回的数组之中，必须包含`a`，否则会报错。
+上面代码中，`obj`对象的`a`属性是不可配置的，这时`ownKeys()`方法返回的数组之中，必须包含`a`，否则会报错。
 
-另外，如果目标对象是不可扩展的（non-extensible），这时`ownKeys`方法返回的数组之中，必须包含原对象的所有属性，且不能包含多余的属性，否则报错。
+另外，如果目标对象是不可扩展的（non-extensible），这时`ownKeys()`方法返回的数组之中，必须包含原对象的所有属性，且不能包含多余的属性，否则报错。
 
 ```javascript
 var obj = {
@@ -958,11 +958,11 @@ Object.getOwnPropertyNames(p)
 // Uncaught TypeError: 'ownKeys' on proxy: trap returned extra keys but proxy target is non-extensible
 ```
 
-上面代码中，`obj`对象是不可扩展的，这时`ownKeys`方法返回的数组之中，包含了`obj`对象的多余属性`b`，所以导致了报错。
+上面代码中，`obj`对象是不可扩展的，这时`ownKeys()`方法返回的数组之中，包含了`obj`对象的多余属性`b`，所以导致了报错。
 
 ### preventExtensions()
 
-`preventExtensions`方法拦截`Object.preventExtensions()`。该方法必须返回一个布尔值，否则会被自动转为布尔值。
+`preventExtensions()`方法拦截`Object.preventExtensions()`。该方法必须返回一个布尔值，否则会被自动转为布尔值。
 
 这个方法有一个限制，只有目标对象不可扩展时（即`Object.isExtensible(proxy)`为`false`），`proxy.preventExtensions`才能返回`true`，否则会报错。
 
@@ -977,9 +977,9 @@ Object.preventExtensions(proxy)
 // Uncaught TypeError: 'preventExtensions' on proxy: trap returned truish but the proxy target is extensible
 ```
 
-上面代码中，`proxy.preventExtensions`方法返回`true`，但这时`Object.isExtensible(proxy)`会返回`true`，因此报错。
+上面代码中，`proxy.preventExtensions()`方法返回`true`，但这时`Object.isExtensible(proxy)`会返回`true`，因此报错。
 
-为了防止出现这个问题，通常要在`proxy.preventExtensions`方法里面，调用一次`Object.preventExtensions`。
+为了防止出现这个问题，通常要在`proxy.preventExtensions()`方法里面，调用一次`Object.preventExtensions()`。
 
 ```javascript
 var proxy = new Proxy({}, {
@@ -997,7 +997,7 @@ Object.preventExtensions(proxy)
 
 ### setPrototypeOf()
 
-`setPrototypeOf`方法主要用来拦截`Object.setPrototypeOf`方法。
+`setPrototypeOf()`方法主要用来拦截`Object.setPrototypeOf()`方法。
 
 下面是一个例子。
 
@@ -1016,11 +1016,11 @@ Object.setPrototypeOf(proxy, proto);
 
 上面代码中，只要修改`target`的原型对象，就会报错。
 
-注意，该方法只能返回布尔值，否则会被自动转为布尔值。另外，如果目标对象不可扩展（non-extensible），`setPrototypeOf`方法不得改变目标对象的原型。
+注意，该方法只能返回布尔值，否则会被自动转为布尔值。另外，如果目标对象不可扩展（non-extensible），`setPrototypeOf()`方法不得改变目标对象的原型。
 
 ## Proxy.revocable()
 
-`Proxy.revocable`方法返回一个可取消的 Proxy 实例。
+`Proxy.revocable()`方法返回一个可取消的 Proxy 实例。
 
 ```javascript
 let target = {};
@@ -1035,9 +1035,9 @@ revoke();
 proxy.foo // TypeError: Revoked
 ```
 
-`Proxy.revocable`方法返回一个对象，该对象的`proxy`属性是`Proxy`实例，`revoke`属性是一个函数，可以取消`Proxy`实例。上面代码中，当执行`revoke`函数之后，再访问`Proxy`实例，就会抛出一个错误。
+`Proxy.revocable()`方法返回一个对象，该对象的`proxy`属性是`Proxy`实例，`revoke`属性是一个函数，可以取消`Proxy`实例。上面代码中，当执行`revoke`函数之后，再访问`Proxy`实例，就会抛出一个错误。
 
-`Proxy.revocable`的一个使用场景是，目标对象不允许直接访问，必须通过代理访问，一旦访问结束，就收回代理权，不允许再次访问。
+`Proxy.revocable()`的一个使用场景是，目标对象不允许直接访问，必须通过代理访问，一旦访问结束，就收回代理权，不允许再次访问。
 
 ## this 问题
 
@@ -1093,7 +1093,7 @@ proxy.getDate();
 // TypeError: this is not a Date object.
 ```
 
-上面代码中，`getDate`方法只能在`Date`对象实例上面拿到，如果`this`不是`Date`对象实例就会报错。这时，`this`绑定原始对象，就可以解决这个问题。
+上面代码中，`getDate()`方法只能在`Date`对象实例上面拿到，如果`this`不是`Date`对象实例就会报错。这时，`this`绑定原始对象，就可以解决这个问题。
 
 ```javascript
 const target = new Date('2015-01-01');