book/es6tutorial
1
0
Fork 0
mirror of https://github.com/ruanyf/es6tutorial.git synced 2025-05-24 18:32:22 +00:00
Code Issues Releases Wiki Activity

docs(proxy): edit defineProperty

Browse Source
This commit is contained in:
ruanyf 2020-05-13 13:35:10 +08:00
parent d65a547832
commit 6f59bc38e1
1 changed files with 31 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
docs/proxy.md
View File

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