diff --git a/docs/proxy.md b/docs/proxy.md index 03df972..e0dfb38 100644 --- a/docs/proxy.md +++ b/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');