Spy

用法: spy(listener).注册一个全局间谍监听器,用来监听所有 MobX 中的事件。它类似于同时在所有的 observable 上附加了一个 observe 监听器,而且还通知关于运行中的事务/反应和计算。举例来说,mobx-react-devtools 中使用了 spy

侦察所有动作的示例用法:

  1. spy((event) => {
  2. if (event.type === 'action') {
  3. console.log(`${event.name} with args: ${event.arguments}`)
  4. }
  5. })

间谍监听器永远接收一个对象,通常至少有一个 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 将会成为空函数,从而实现最小化。