3. Observable类型 - 3.3. maps

observable.map(values)

observable.map(values?) - 创建一个动态键的 observable 映射。
如果你不但想对一个特定项的更改做出反应，而且对添加或删除该项也做出反应的话，那么 observable 映射会非常有用。
observable.map(values) 中的 values 可以是对象、 数组或者字符串键的 ES6 map。
与 ES6 map 不同的是，键只能是字符串。

通过 ES6 Map 构造函数，你可以使用 observable(new Map()) 或使用装饰器 @observable map = new Map() 的类属性来初始化 observable 映射 。

下列 observable 映射所暴露的方法是依据 ES6 Map 规范:

• has(key) - 返回映射是否有提供键对应的项。注意键的存在本身就是可观察的。
• set(key, value) - 把给定键的值设置为 value 。提供的键如果在映射中不存在的话，那么它会被添加到映射之中。
• delete(key) - 把给定键和它的值从映射中删除。
• get(key) - 返回给定键的值(或 undefined)。
• keys() - 返回映射中存在的所有键。插入顺序会被保留。
• values() - 返回映射中存在的所有值。插入顺序会被保留。
• entries() - 返回一个(保留插入顺序)的数组，映射中的每个键值对都会对应数组中的一项 [key, value]。
• forEach(callback:(value, key, map) => void, thisArg?) - 为映射中每个键值对调用给定的回调函数。
• clear() - 移除映射中的所有项。
• size - 返回映射中项的数量。

以下函数不属于 ES6 规范，而是由 MobX 提供:

• toJS() - 返回映射的浅的普通对象表示。(深复制使用 mobx.toJS(map))。
• intercept(interceptor) - 可以用来在任何变化作用于映射前将其拦截。参见 observe & intercept。
• observe(listener, fireImmediately?) - 注册侦听器，在映射中的每个更改时触发，类似于为 Object.observe 发出的事件。想了解更多详情，请参见 observe & intercept。
• merge(values) - 把提供对象的所有项拷贝到映射中。values 可以是普通对象、entries 数组或者 ES6 字符串键的映射。
• replace(values) - 用提供值替换映射全部内容。是 .clear().merge(values) 的简写形式。

observable.shallowMap(values)

任何分配给 observable 映射的值都会默认通过 observable 来传递使其转变成可观察的。
创建浅映射以禁用此行为，并按原样存储值。关于此机制的更多详情，请参见 调节器。

名称参数

observable.map 和 observable.shallowMap 都接收第二个参数作为 spy 或者 MobX 开发者工具中的调试名称。