Spy
用法: spy(listener).
注册一个全局间谍监听器,用来监听所有 MobX 中的事件。
它类似于同时在所有的 observable 上附加了一个 observe 监听器,而且还通知关于运行中的事务/反应和计算。
举例来说,mobx-react-devtools 中使用了 spy。
侦察所有动作的示例用法:
spy((event) => {
if (event.type === 'action') {
console.log(`${event.name} with args: ${event.arguments}`)
}
})
间谍监听器永远接收一个对象,通常至少有一个 type 字段。默认情况下,spy 会发出以下事件。
| 事件 | 字段 | 嵌套的 |
|---|---|---|
| action | name, object (作用域), arguments | yes |
| scheduled-reaction | name | no |
| reaction | name | yes |
| compute | name | no |
| error | message | 否 |
| update (数组) | object (数组), index, newValue, oldValue | 是 |
| update (映射) | object (observable map 实例), name, newValue, oldValue | 是 |
| update (对象) | object (实例), name, newValue, oldValue | 是 |
| splice (数组) | object (数组), index, added, removed, addedCount, removedCount | 是 |
| add (映射) | object, name, newValue | 是 |
| add (对象) | object, name, newValue | 是 |
| delete (映射) | object, name, oldValue | 是 |
| create (boxed observable) | object (ObservableValue 实例), newValue | 是 |
注意签名是 { spyReportEnd: true, time? } 的事件。
这些事件可能没有 type 字段,但是它们是具有 spyReportStart:true 的早期触发事件的一部分。
该事件指示事件的结束,并且以这种方式创建具有子事件的事件组。
此事件同样也可以报告总执行时间。
Observable 值的间谍事件与传递给 observe 的事件相同。想了解更多,请参见 intercept & observe。
在打包生产版本时,spy API 将会成为空函数,从而实现最小化。