返回：唐霜｜书

Objext完全手册

前言

Objext是一个现代js对象模型，它通【未经授权禁止转载】【作者：唐霜】过丰富的api扩展js原生模型，使一个对【转载请注明来源】著作权归作者所有，禁止商业用途转载。象拥有更丰富的操作和数据读写能力，同时可【本文首发于唐霜的博客】【转载请注明来源】以使之更符合响应式编程的需要。

未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。

之所以开发Objext，一开始是为了解决【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。在表单中创建一个可编辑和撤销编辑的对象。本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net在这个场景中，当一个对象被表单打开时，它【作者：唐霜】【未经授权禁止转载】进入可编辑状态，当提交表单时，它会被更新【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net，当放弃提交表单时，它恢复到编辑前的数据转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】。在这个原始需求的基础上，我增加，当一个【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net属性发生变动时，可以执行某些操作，就像v未经授权，禁止复制转载。未经授权，禁止复制转载。ue可以更新视图一样，通过提供一个$wa转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】tch方法，这种能力被封装的近乎完美。除【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】了解决属性变动的监听，我还想到表单的校验本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】问题，提交表单的时候需要对表单数据进行校【版权所有，侵权必究】转载请注明出处：www.tangshuang.net验。最后，一个包含如下功能的Objext【转载请注明来源】原创内容，盗版必究。对象就诞生了：

【未经授权禁止转载】【原创不易，请尊重版权】

通过keyPath获取、设置数据

【未经授权禁止转载】

【关注微信公众号：wwwtangshuangnet】

未经授权，禁止复制转载。

响应式，可以通过$watch监听某个ke【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】yPath

原创内容，盗版必究。

【转载请注明来源】

数据版本控制，通过$commit和$re【本文首发于唐霜的博客】【转载请注明来源】set，可以随时创建快照或恢复数据

转载请注明出处：www.tangshuang.net

【关注微信公众号：wwwtangshuangnet】

【本文受版权保护】

数据校验

【作者：唐霜】

【访问 www.tangshuang.net 获取更多精彩内容】

著作权归作者所有，禁止商业用途转载。

数据锁，锁住之后，不能做任何数据修改

【未经授权禁止转载】

著作权归作者所有，禁止商业用途转载。

计算属性和依赖收集

著作权归作者所有，禁止商业用途转载。

本文作者：唐霜，转载请注明出处。

著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】

本手册将会介绍上述这些功能如何使用，以及本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。它们背后的实现原理，通过了解这些原理，可【转载请注明来源】【访问 www.tangshuang.net 获取更多精彩内容】以避免一些错误的使用场景。

【未经授权禁止转载】原创内容，盗版必究。

快速上手

本节让你快速使用Objext创建一个对象【原创不易，请尊重版权】【关注微信公众号：wwwtangshuangnet】，这个对象几乎和普通的js对象的用法一模【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。一样，只不过你可以监听某个属性的变化。

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。

安装和使用

objext通过npm进行安装：

npm i objext

安装之后，可以通过不同的方式在项目中引入原创内容，盗版必究。本文作者：唐霜，转载请注明出处。：

【作者：唐霜】本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】

// ES6
import Objext from 'objext'

// CommonJS
const { Objext } = require('objext')

浏览器中也可以直接引入使用：

<script src="node_moudules/objext/dist/objext.js"></script>
<script>
const { Objext } = window.objext
</script>

创建实例

创建一个Objext实例超级简单，只需要【转载请注明来源】【未经授权禁止转载】传入一个等同结构的js原生对象即可。

【本文首发于唐霜的博客】【转载请注明来源】【原创内容，转载请注明出处】

const objx = new Objext({
  name: 'susan',
  children: [
    { name: 'tomy', age: 9 },
    { name: 'lily', age: 10 },
  ],
})

这样就创建了一个Objext的实例。它的【本文首发于唐霜的博客】未经授权，禁止复制转载。使用几乎可以和普通的js对象一样：

const child1 = objx.children[0]
child1.age = 10

本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。

objx.$watch('children[0].age', ({ newValue }) => {
  objx.children[1].age = newValue + 1
})

本文作者：唐霜，转载请注明出处。【转载请注明来源】【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】

const some = new Objext({
  weight: 120,
  get height() {
    return this.weight + 50
  }, 
})

这样，height就是一个计算属性，它依【原创不易，请尊重版权】【原创不易，请尊重版权】赖于weight，当weight发生变化【作者：唐霜】【作者：唐霜】的时候，height也发生变化，但是和原【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.net生的计算属性相比，objext实例的计算【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】属性使用来缓存，当weight发生变化的【本文受版权保护】【本文首发于唐霜的博客】时候，缓存被更新，获取height时，直【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。接读取缓存。

【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】

【本文受版权保护】【原创内容，转载请注明出处】未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。

基于keyPath的数据操作

keyPath是指获取一个多层级数据节点本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.net的属性链的字符串表达形式，例如obx.b著作权归作者所有，禁止商业用途转载。【版权所有，侵权必究】ody.hands.left这个属性节点原创内容，盗版必究。本文作者：唐霜，转载请注明出处。，它的keyPath就是’b本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。ody.hands.left’【关注微信公众号：wwwtangshuangnet】【本文受版权保护】;，而在objext中，我们可以使用ke【关注微信公众号：wwwtangshuangnet】【未经授权禁止转载】yPath来获取或更新数据。

之所以提供这种方式，是因为，我们直接ob【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。x.body.hands.left会遇到【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】问题，在某些情况下，这个属性节点并不存在【转载请注明来源】【原创内容，转载请注明出处】，比如obx.body根本就不存在，那么本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】这个操作就会报错，影响程序执行。而通过o本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。bjext的keyPath进行操作，则不转载请注明出处：www.tangshuang.net【本文受版权保护】会影响。

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

$get

通过keyPath获取属性节点。

【转载请注明来源】【本文受版权保护】【原创内容，转载请注明出处】

keyPath 要获取的属性节点的key【作者：唐霜】本文版权归作者所有，未经授权不得转载。Path

转载请注明出处：www.tangshuang.net

未经授权，禁止复制转载。

【本文首发于唐霜的博客】

原创内容，盗版必究。

const left = objx.$get('body.hands.left')

本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net【未经授权禁止转载】

需要注意的是，$get得到的，不是一个数【原创不易，请尊重版权】【转载请注明来源】据的原始值，而是objext实例的属性节【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。点，如果该节点对应的原始数据是一个对象，【本文受版权保护】【未经授权禁止转载】那么这个节点本身将会是一个objext实【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。例，同时具备了一切objext的特性。这本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。涉及到objext的内部层级问题，后文会转载请注明出处：www.tangshuang.net【未经授权禁止转载】更深入的讲解。

另外，如果你直接在objext实例上添加【未经授权禁止转载】本文作者：唐霜，转载请注明出处。一个属性，例如 objx.age = 1【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。0 这种，$get是获取不到这种属性的。【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.net这是一个比较忌讳的做法，因此，一定要记住原创内容，盗版必究。转载请注明出处：www.tangshuang.net，永远不要直接在objext实例对象上添【原创内容，转载请注明出处】【本文受版权保护】加属性，也不要用delete操作符直接删【关注微信公众号：wwwtangshuangnet】【本文受版权保护】除属性，而要使用objext的实例方法$未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】set和$remove。

【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】

$set

通过keyPath更新或添加一个属性节点原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。。

【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。

keyPath 要设置的属性节点的key本文版权归作者所有，未经授权不得转载。【版权所有】唐霜 www.tangshuang.netPath

未经授权，禁止复制转载。

本文作者：唐霜，转载请注明出处。

value 值

【作者：唐霜】

本文版权归作者所有，未经授权不得转载。

【访问 www.tangshuang.net 获取更多精彩内容】

objx.$set('body.hands.left', true')

当节点不存在时，这个节点会被添加。即使b本文作者：唐霜，转载请注明出处。【作者：唐霜】ody这个节点不存在，body, han著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】ds, left都会被逐一添加，这样可以转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】保证开发者真正的目的实现，而且还不会报错【本文受版权保护】著作权归作者所有，禁止商业用途转载。。

【作者：唐霜】【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】

objext的特点是响应式的，可以通过$【未经授权禁止转载】本文作者：唐霜，转载请注明出处。watch对属性的变化进行响应。当你使用原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。$set进行数据更改或添加时，对应的wa【原创内容，转载请注明出处】【原创内容，转载请注明出处】tcher会被触发。注意，添加数据也会触本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net发watcher哦。

【转载请注明来源】【本文受版权保护】

那如果要添加一个不是响应式的，但是又不会著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。被删掉的属性怎么办呢？需要用到后面的$d著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。efine，后文会详细介绍。

而另外一种情况是，如果你想在单个操作中，【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。仅仅更新属性值，而不触发watcher怎【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。么办呢？$set的第三个参数设置为fal【未经授权禁止转载】【作者：唐霜】se即可：

dispatch 是否要触发watche【版权所有】唐霜 www.tangshuang.net原创内容，盗版必究。r，默认为true

【访问 www.tangshuang.net 获取更多精彩内容】

本文版权归作者所有，未经授权不得转载。

objx.$set('body.hands.left', true, false)

这样就不会触发通过$watch绑定的wa本文版权归作者所有，未经授权不得转载。【本文受版权保护】tcher。

$has

判断是否存在一个属性节点。

转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。【转载请注明来源】本文版权归作者所有，未经授权不得转载。

keyPath 要判断的属性节点keyP本文作者：唐霜，转载请注明出处。【作者：唐霜】ath

【未经授权禁止转载】

【访问 www.tangshuang.net 获取更多精彩内容】

【本文受版权保护】

if (objx.$has('body.hands')) {
  // ...
}

需要注意的是，如果这个属性是直接通过js【原创内容，转载请注明出处】【本文首发于唐霜的博客】原生的属性赋值的方式添加上去的，那么$h【本文受版权保护】著作权归作者所有，禁止商业用途转载。as也是判断不到的，会返回fasle，这【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】和$get的道理是一样的。

$update

批量更新/添加属性节点。

本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。

object 将要更新的内容通过一个对象未经授权，禁止复制转载。未经授权，禁止复制转载。的形式组织起来

本文作者：唐霜，转载请注明出处。

【作者：唐霜】

objx.$update({
  name: 'susan',
  age: 34,
})

通过这种方式可以一次性写入多个属性。当一【转载请注明来源】【作者：唐霜】个属性不存在时，会自动创建该属性。

原创内容，盗版必究。【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】

使用$update的好处是批量。这听上去【本文受版权保护】【原创内容，转载请注明出处】是废话，但是并不是，普通$set一个一个【原创内容，转载请注明出处】【原创内容，转载请注明出处】更新属性，不仅写法上比较麻烦，而且每一次【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】$set都会触发watcher去执行，这转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。会影响后面的$set的值。但是$upda【本文受版权保护】【本文受版权保护】te会在一次更新完之后，才会去执行所有涉【原创内容，转载请注明出处】【本文受版权保护】及到的所有watcher。这就可能出现比【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。较有趣的现象，当你使用一组$set和使用【原创内容，转载请注明出处】【原创不易，请尊重版权】$update的时候，虽然他们都是更新相【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】同的一批数据，但是有可能执行完毕之后，整转载请注明出处：www.tangshuang.net【本文受版权保护】个objx的值不同，这是因为watche本文版权归作者所有，未经授权不得转载。【作者：唐霜】r的执行顺序可能不同导致的。因此，在使用【本文受版权保护】【原创内容，转载请注明出处】的时候，你需要注意。

【原创不易，请尊重版权】未经授权，禁止复制转载。

$put

object 要使用的新数据

【作者：唐霜】

本文作者：唐霜，转载请注明出处。

看上去$update和$put很像，但实本文作者：唐霜，转载请注明出处。【作者：唐霜】际上，完全不同，$update简单理解是【转载请注明来源】本文版权归作者所有，未经授权不得转载。多个$set同时执行，而$put则是现$【原创内容，转载请注明出处】【未经授权禁止转载】remove所有已经存在的数据，然后在$原创内容，盗版必究。本文作者：唐霜，转载请注明出处。set给的数据。

【作者：唐霜】【本文受版权保护】

在删除阶段，objext实例上所有的属性原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。都会被删除，这也就是为什么不能通过js原本文作者：唐霜，转载请注明出处。【本文受版权保护】生赋值的形式新增属性的原因之一。

【未经授权禁止转载】转载请注明出处：www.tangshuang.net

const age = objx.$get('age')
objx.$put({
  name: 'susan',
})

【本文受版权保护】未经授权，禁止复制转载。

$remove

从objext实例上删除一个属性。

keyPath 要移除的属性节点keyP【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。ath

本文作者：唐霜，转载请注明出处。

【未经授权禁止转载】

objx.$remove('body.hands')

有人可能会问，移除直接delete不就行本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】了嘛。听上去很简单，实际上，在objex未经授权，禁止复制转载。【本文首发于唐霜的博客】t内部存在依赖关系，如果一个属性依赖另外著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】一个属性，那么当被依赖的属性被移除时，应原创内容，盗版必究。【转载请注明来源】该解除这种依赖关系。单纯delete做不【转载请注明来源】著作权归作者所有，禁止商业用途转载。到，因此，必须使用$remove来移除所【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】有你需要移除的属性。

未经授权，禁止复制转载。【原创内容，转载请注明出处】【原创内容，转载请注明出处】

响应式

Objext的一个特征是完全的响应式，它著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】可以塑造多种响应式方式，而且脱离了任何业【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】务场景，是一个纯粹的对象响应式的库。它不【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。考虑界面响应的问题，它可以用来解决任何需【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net要观察数据变化而跟随变化的场景，虽然需要【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.net自己编写被响应的代码。

计算属性

计算属性被大规模应用是vue出现的时候，【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】在vue中，我们需要将普通的数据和计算属【原创不易，请尊重版权】未经授权，禁止复制转载。性数据分开写，这不是没有道理的，因为计算未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】属性意味着不可以手动去修改它的值。在ob【未经授权禁止转载】未经授权，禁止复制转载。jext中也是一样的，如果一个属性是计算本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。属性，就不能通过$set或者赋值的方式去【转载请注明来源】著作权归作者所有，禁止商业用途转载。修改它的值。

所以，到底应该怎么使用计算属性呢？

【本文首发于唐霜的博客】【本文首发于唐霜的博客】【原创内容，转载请注明出处】未经授权，禁止复制转载。

创建计算属性

创建计算属性超级简单：

const objx = new Objext({
  age: 10, 
  get weight() {
    return age * 10
  }, 
})

就像js原生对象的getter一样。但是【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。需要注意的是，如果你还设置了一个sett【作者：唐霜】【作者：唐霜】er，那setter会被直接忽略，你不可未经授权，禁止复制转载。未经授权，禁止复制转载。以在objext中使用setter，se【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】tter应该被$watch替代。

著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net【未经授权禁止转载】

使用计算属性

【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】

使用计算属性和其他普通属性是一模一样的，著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。不同之处在于，计算属性本身会根据所依赖的【作者：唐霜】【本文首发于唐霜的博客】属性的变化自动变化。

console.log(objx.weight) // 100
objx.age = 11
console.log(objx.weight) // 110

计算器中的this

计算器是指创建计算属性时，给的计算函数。转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net计算函数可以是含有this的作用域函数。【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。这个this，在正常情况下代表当前所在的未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】objext对象，例如：

【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】

const objx = new Objext({
  age: 10,
  get weight() {
    return this.age * 10
  },
})

weight计算器中的this指代的就是【原创不易，请尊重版权】转载请注明出处：www.tangshuang.netobjx。但是，在一些情况下，这个thi本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。s可以被bind到其他objext对象上【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。。

转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。

const objx2 = new Objext({
  age: 20,
})
objx.$bind(objx2)

使用$bind方法，使objx的weig本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】ht计算器中的this换绑到objx2上【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net面，这样，当objx2.age发生变化的原创内容，盗版必究。【原创内容，转载请注明出处】时候，objx.weight就会自动更新本文版权归作者所有，未经授权不得转载。【转载请注明来源】。但是，需要注意的是，$bind方法会使【本文受版权保护】【未经授权禁止转载】所有的计算器的this都换绑，而不是只换【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。绑一个计算器。因此，在使用$bind时，著作权归作者所有，禁止商业用途转载。【本文受版权保护】也要理解它的运作规律才使用。

【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。

当一个计算属性依赖另外一个objext对【本文受版权保护】未经授权，禁止复制转载。象的某个属性时，可以使用$depend方本文作者：唐霜，转载请注明出处。【作者：唐霜】法创建这种依赖关系：

const objx = new Objext({
  get weight() {
    return objx2.age * 10 // 依赖objx2的age属性
  },
})

这里，objx依赖objx2.age，o本文作者：唐霜，转载请注明出处。原创内容，盗版必究。bjx2也是一个objext对象，但是o【转载请注明来源】原创内容，盗版必究。bjx2的age属性发生变化的时候，并不【关注微信公众号：wwwtangshuangnet】【作者：唐霜】能直接触发objx的weight发生变化【转载请注明来源】【原创不易，请尊重版权】，为了解决这个问题，你需要使用$depe【版权所有，侵权必究】【本文受版权保护】nd方法：

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net

objx.$depend(objx)

这需要你手动调用，而不能靠objext自本文作者：唐霜，转载请注明出处。【未经授权禁止转载】动实现。

【原创内容，转载请注明出处】【原创内容，转载请注明出处】原创内容，盗版必究。

$watch

$watch方法为objext实例提供一【本文首发于唐霜的博客】【本文受版权保护】个观察者，对特定keyPath的属性进行【版权所有，侵权必究】原创内容，盗版必究。观察，当该属性发生变化时，执行传入的回调【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。函数。它的使用非常像angular的$w转载请注明出处：www.tangshuang.net【作者：唐霜】atch方法。

【未经授权禁止转载】【原创不易，请尊重版权】

keyPath 要观察的属性

【关注微信公众号：wwwtangshuangnet】

【访问 www.tangshuang.net 获取更多精彩内容】

转载请注明出处：www.tangshuang.net

fn 属性发生变化时要执行的函数

著作权归作者所有，禁止商业用途转载。

原创内容，盗版必究。

deep 是否要进行深度观察，当keyP【本文首发于唐霜的博客】【作者：唐霜】ath对应的是对象或数组时可以设为tru【版权所有，侵权必究】原创内容，盗版必究。e

转载请注明出处：www.tangshuang.net

原创内容，盗版必究。

【本文受版权保护】

objx.$watch('body.hands.left', ({ newValue }) => {
  console.log(newValue)
})

$watch方法是实现objext内部响未经授权，禁止复制转载。【原创不易，请尊重版权】应式功能的基础方法，因此，它会被广泛用到转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net，包括objext内部的响应式实现方式，转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。例如计算属性的自动更新。

回调函数fn的参数包括：

e 一个包含属性变化信息的对象

【访问 www.tangshuang.net 获取更多精彩内容】

【原创内容，转载请注明出处】

newValue 新值

【转载请注明来源】

原创内容，盗版必究。

oldValue 老值

【原创不易，请尊重版权】

【未经授权禁止转载】

【本文受版权保护】

其中e，也就是第一个参数，会包含如下信息【本文受版权保护】本文作者：唐霜，转载请注明出处。：

本文作者：唐霜，转载请注明出处。原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】

match $watch时的keyPat【版权所有，侵权必究】本文作者：唐霜，转载请注明出处。h

【原创内容，转载请注明出处】

【作者：唐霜】

deep $watch时的deep

【原创内容，转载请注明出处】

【转载请注明来源】

path 当前变化的真实节点的keyPa原创内容，盗版必究。【转载请注明来源】th

【访问 www.tangshuang.net 获取更多精彩内容】

著作权归作者所有，禁止商业用途转载。

【转载请注明来源】

target 当前objext对象

著作权归作者所有，禁止商业用途转载。

【关注微信公众号：wwwtangshuangnet】

newValue 新值

转载请注明出处：www.tangshuang.net

著作权归作者所有，禁止商业用途转载。

原创内容，盗版必究。

本文作者：唐霜，转载请注明出处。

oldValue 老值

转载请注明出处：www.tangshuang.net

【访问 www.tangshuang.net 获取更多精彩内容】

stopPropagation 阻止冒泡

转载请注明出处：www.tangshuang.net

著作权归作者所有，禁止商业用途转载。

preventDefault 阻止继续执转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】行其他回调函数

【原创内容，转载请注明出处】

转载请注明出处：www.tangshuang.net

本文作者：唐霜，转载请注明出处。

stack 调用栈

本文作者：唐霜，转载请注明出处。

【转载请注明来源】

stopPropagation

未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net【未经授权禁止转载】

objext的$watch的第三个参数d本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】eep让你可以对一个本身是对象的属性进行【本文受版权保护】【版权所有】唐霜 www.tangshuang.net深度观察。当深层次的节点发生变化的时候，【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。代表着被观察的节点也发生了变化。它的内部本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。实现机理和DOM的事件冒泡一样，一层一层【本文首发于唐霜的博客】【原创不易，请尊重版权】向上传递，触发对应的回调函数。但是，如果本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。你在向上冒泡的过程中，调用了stopPr【版权所有】唐霜 www.tangshuang.net转载请注明出处：www.tangshuang.netopagation方法的话，冒泡就会停止转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。，向上的后续回调函数就不会执行了。例如：

未经授权，禁止复制转载。【本文受版权保护】未经授权，禁止复制转载。【未经授权禁止转载】

objx.$watch('body.hands', ({ newValue }) => {
  console.log(newValue)
}, true)
objx.$watch('body.hands.left', ({ newValue, stopPropagation }) => {
  if (newValue === true) {
    stopPropagation()
  }
})

preventDefault

【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。

objx.$watch('body.hands.left', ({ newValue, preventDefault }) => {
  if (newValue === true) {
    preventDefault()
  }
})
objx.$watch('body.hands.left', (e, newValue) => {
  console.log(newValue)
})

上面的代码中，如果body.hands.【原创不易，请尊重版权】【作者：唐霜】left为true，那么第二个回调函数就【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】不会被执行了。

【转载请注明来源】著作权归作者所有，禁止商业用途转载。

特殊符号

本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】【本文首发于唐霜的博客】

特殊符号*表示对所有的变化进行观察：

原创内容，盗版必究。【转载请注明来源】

objx.$watch('*', ({ path, match }) => {
  console.log('观察' + match)
  console.log('发生变化的是' + path)
})

$unwatch

$unwatch是$watch的反函数，【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。用于对某个观察者进行解绑，解绑之后回调函【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。数就不会被调用了。

本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】

objx.$watch('body', callback)
// ...
objx.$unwatch('body', callback)

$silent

【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】

status 使用状态true/fals【作者：唐霜】本文版权归作者所有，未经授权不得转载。e，true表示开启安静模式，false【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。表示关闭安静模式。

未经授权，禁止复制转载。

转载请注明出处：www.tangshuang.net

$isSilent

判断是否处于安静模式中。

数据版本控制

Objext对象的一个特点是可以随意的修转载请注明出处：www.tangshuang.net原创内容，盗版必究。改和恢复数据，特别是在一些编辑的时候，你转载请注明出处：www.tangshuang.net【未经授权禁止转载】可以提供临时保存和恢复的能力。当你放弃进【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。行编辑的时候，一个方法就可以让数据恢复到【未经授权禁止转载】转载请注明出处：www.tangshuang.net编辑之初的状态。

【本文受版权保护】【关注微信公众号：wwwtangshuangnet】

$commit

创建一个名为tag的快照。

【本文首发于唐霜的博客】【本文首发于唐霜的博客】

tag 快照名称

【访问 www.tangshuang.net 获取更多精彩内容】

著作权归作者所有，禁止商业用途转载。

未经授权，禁止复制转载。

【作者：唐霜】

objx.$commit('tag1')

打完一个tag之后，会在内部保存当时的所未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】有数据，并建立一个快照，后续对objex著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。t对象的修改，不会影响快照内容。

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】【本文首发于唐霜的博客】

不能存在同名快照，如果已经存在了同名快照【作者：唐霜】原创内容，盗版必究。，会被新快照覆盖。

【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。【本文受版权保护】

$reset

恢复到名为tag的快照的数据。

原创内容，盗版必究。【转载请注明来源】转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。

tag 快照的名称。如果不传的话，直接恢【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。复到最后一个创建的快照，即使已经存在同名【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net快照，也会被认为是最后一个。

未经授权，禁止复制转载。

objx.name = 'tomy'
objx.$commit('version1')
objx.name = 'jimy'
objx.$reset('version1')
console.log(objx.name) // => 'tomy'

reset之后名为tag的快照还是存在的转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。，只是当前的数据被设置为快照的内容。

本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】

$revert

删除名为tag的快照。

tag 快照的名称。如果不传，表示删除上【本文受版权保护】【版权所有】唐霜 www.tangshuang.net一个创建的快照，规则和reset相同。

未经授权，禁止复制转载。

本文作者：唐霜，转载请注明出处。

objx.name = 'tomy'
objx.$commit('version1')
objx.name = 'jimy'
objx.$commit('version2')
objx.name = 'gofei'
objx.$revert() // 删除version2
objx.$reset() // 恢复到version1
console.log(objx.name) // => 'tomy'

数据锁

在一些情况下，我们可以锁死objext实【本文受版权保护】【原创不易，请尊重版权】例，使它不能进行任何修改。

【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。【转载请注明来源】

$lock

锁死数据。

【本文首发于唐霜的博客】原创内容，盗版必究。【本文受版权保护】

objx.name = 'digou'
objx.$lock()
objx.name = 'ximeon'
console.log(objx.name) // digou

锁死后，属性不能被修改。

【作者：唐霜】未经授权，禁止复制转载。【作者：唐霜】

objext具有继承性，父级属性锁死后，本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。子属性也不能修改。

本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。

objx.body.$lock()
objx.body.hands.left = true // 无法进行修改

$unlock

解锁数据，使返回可修改状态。

【本文受版权保护】【原创不易，请尊重版权】【转载请注明来源】

$isLocked

判断是否被锁死。

【作者：唐霜】转载请注明出处：www.tangshuang.net

数据校验

本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

$formulate

设置校验规则。

原创内容，盗版必究。本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。

validators 可以是一个数组，也本文版权归作者所有，未经授权不得转载。【版权所有，侵权必究】可以是单个对象，对象内容为：
- path 要校验的keyPath
- determine 一个函数，用以决定是【原创内容，转载请注明出处】未经授权，禁止复制转载。否要执行当前这个校验规则
- validate 校验器函数，返回tru【原创内容，转载请注明出处】【版权所有】唐霜 www.tangshuang.nete/false
- message 校验不通过时，会返回一个本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。Error，该message将作为错误信【转载请注明来源】本文版权归作者所有，未经授权不得转载。息
- warn 一个函数，用以接受校验失败时返【本文受版权保护】本文版权归作者所有，未经授权不得转载。回的error，然后进行下一步处理
- deferred 是否异步校验，为tru【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。e时表示异步校验，异步校验不会阻塞校验过【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。程，需要在warn中接受error进行后【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net续处理
- order 校验顺序值，值越大越早校验

【原创内容，转载请注明出处】

objx.$formulate({
  path: 'body.hands.left',
  validate: value => typeof value === 'boolean',
  message: '必须为true/false',
  warn: error => window.toast(error.message),
})

objx.$strict()
objx.body.hands.left = 'true' // 报错

determine, validate,转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net warn中都可以使用this，指向当前【转载请注明来源】【版权所有】唐霜 www.tangshuang.netcontext，当前context通过$【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】bind方法绑定，没有绑定时，表示obj原创内容，盗版必究。【原创内容，转载请注明出处】ext对象自身。

【转载请注明来源】转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。

$validate

执行校验器。

【本文首发于唐霜的博客】原创内容，盗版必究。【原创不易，请尊重版权】【原创不易，请尊重版权】

【作者：唐霜】

本文作者：唐霜，转载请注明出处。

本文版权归作者所有，未经授权不得转载。

nextData 该keyPath将要使本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】用的值，可选

【原创不易，请尊重版权】

【转载请注明来源】

著作权归作者所有，禁止商业用途转载。

本文作者：唐霜，转载请注明出处。【未经授权禁止转载】【原创不易，请尊重版权】

objx.$validate('name', 'Timy')

$strict

转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

status 设为true表示开启，fa【本文受版权保护】【未经授权禁止转载】lse表示关闭

【本文首发于唐霜的博客】

【本文受版权保护】

和$silent很像，也具有继承性。

本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。

$isStrict

判断是否处于严格模式下。

原创内容，盗版必究。【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net

高级用法

批量更新

我们可能会一次性更新多个值，普通模式下，本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】每一次更新，都会触发watcher，一次【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】watcher执行，可能带来不同的结果，本文作者：唐霜，转载请注明出处。转载请注明出处：www.tangshuang.net特别是有依赖性时。一般来讲，我们使用$u【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。pdate进行批量更新，但是，你也可以自【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】己构造批量更新。

$start

开启批量更新模式，开启后，watcher【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。不会被触发，直到调用$end。

$end

完成批量更新，关闭批量更新模式，并且触发【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】涉及到的所有watcher。

著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】

objx.$start()
objx.name = 'tom'
objx.age = 10
objx.name ='tomi'
objx.$end()

实例依赖

普通对象中的this仅会指向自身，但是由本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】于objext具备响应式能力，因此，有更转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。丰富的依赖接口。例如objx1依赖obj【本文首发于唐霜的博客】【原创不易，请尊重版权】x2，那么当objx2中的某个发生变化时【转载请注明来源】原创内容，盗版必究。，objx1对应的属性也应该发生变化。

$depend

跨实例的属性依赖。

未经授权，禁止复制转载。【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】

著作权归作者所有，禁止商业用途转载。

【关注微信公众号：wwwtangshuangnet】

转载请注明出处：www.tangshuang.net

【本文受版权保护】

【本文首发于唐霜的博客】

dependency 被依赖的实例的那个【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net属性是被依赖的，可选，不传的情况下，会被【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】自动识别

未经授权，禁止复制转载。

【本文首发于唐霜的博客】

【作者：唐霜】

const objx1 = new Objext({
  get weight() {
    return objex2.age
  },
})
objx1.$depend('weight', objx2)

上面的代码表示，objx1.weight转载请注明出处：www.tangshuang.net【未经授权禁止转载】依赖于objx2.age，当objx2.【作者：唐霜】本文作者：唐霜，转载请注明出处。age发生变化时，objx1.weigh著作权归作者所有，禁止商业用途转载。【转载请注明来源】t也会发生变化。

原创内容，盗版必究。未经授权，禁止复制转载。

这里需要注意的是，由于现实的限制，上面的本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】代码中，如果没有$depend那一句，o【原创不易，请尊重版权】【原创不易，请尊重版权】bjx1.weight将永远使用第一次初【关注微信公众号：wwwtangshuangnet】【作者：唐霜】始化的缓存，而不会被修改。因此，如果要使转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】之根据实际情况进行修改，那么必须调用$d【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。epend绑定响应式关系。

$undepend

$depen的反函数，解除依赖关系。

【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。

$bind

修改当前objext实例的context【本文受版权保护】本文版权归作者所有，未经授权不得转载。。在objext实例的计算器、校验器等函【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net数中的this，将会使用$bind的参数【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。取代。

【本文受版权保护】【原创内容，转载请注明出处】原创内容，盗版必究。转载请注明出处：www.tangshuang.net

target 必须是objext实例，用著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。以替代this的指向

【本文首发于唐霜的博客】

著作权归作者所有，禁止商业用途转载。

转载请注明出处：www.tangshuang.net

const objx1 = new Objext({
  age: 10,
  get weight() {
    return this.age + 10
  },
})
const objx2 = new Objext({
  age: 11,
})
objx1.$bind(objx2)

上面代码中的$bind导致objx1中的本文版权归作者所有，未经授权不得转载。【本文受版权保护】计算属性中的this指代objx2。

【原创内容，转载请注明出处】【作者：唐霜】

要使得解除绑定关系，恢复this指代当前本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。实例，$bind参数为null即可。

【本文受版权保护】【本文受版权保护】转载请注明出处：www.tangshuang.net【本文受版权保护】

对比

通过objext进行数据对比超级方便。

本文作者：唐霜，转载请注明出处。【转载请注明来源】原创内容，盗版必究。【转载请注明来源】

$hash

objext实例的$hash属性保存了它本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。的当前hash值，两个objext对象的本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】hash值相同，表示他们拥有相同的数据内【未经授权禁止转载】原创内容，盗版必究。容。

未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。

objx1.$hash === objx2.$hash

静态方法

Objext提供了几个静态方法，可帮助开【未经授权禁止转载】【原创不易，请尊重版权】发者快速实现一些功能。

原创内容，盗版必究。【本文受版权保护】

isEqual

判断两个对象/值是否具有相同的内容。

【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】【本文受版权保护】

Objext.isEqual(obj1, obj2)

isEmpty

isArray

判断是否为数组。

著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。

isObject

判断是否为纯对象。所谓纯对象，是指非实例本文作者：唐霜，转载请注明出处。原创内容，盗版必究。的字面量对象，比如 o = {} 这种。

未经授权，禁止复制转载。【作者：唐霜】【关注微信公众号：wwwtangshuangnet】

inArray

判断一个值是否存在于数组中。

【作者：唐霜】【未经授权禁止转载】

Objext.inArray(item, items)

inObject

判断一个key是否存在于对象中。只有可枚【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。举的key被识别。

【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。【转载请注明来源】

Object.inObject(key, obj)

isInstanceOf

判断一个对象是否是一个类的实例。

Objext.isInstanceOf(obj, ClassObj)

parse

通过keyPath解析获得属性值。

本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。

let value = Objext.parse(obj, 'body.hands.left')

assign

通过keyPath设置值。

Objext.assign(obj, 'some.name.len', 10)

clone

克隆一个对象。

结语

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。原创内容，盗版必究。

基于Objext，你可以扩展出更有意思的转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。工具出来，它提供了一个思想，让你可以对自转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。己的对象数据为所欲为。

【本文受版权保护】原创内容，盗版必究。【本文受版权保护】【原创不易，请尊重版权】

【版权所有】唐霜 www.tangshuang.net【本文受版权保护】【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。转载请注明出处：www.tangshuang.net原创内容，盗版必究。【版权所有，侵权必究】【版权所有】唐霜 www.tangshuang.net【转载请注明来源】本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。【本文首发于唐霜的博客】【版权所有，侵权必究】【转载请注明来源】【作者：唐霜】【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】【版权所有，侵权必究】【本文受版权保护】转载请注明出处：www.tangshuang.net【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。

如果你觉得本书对你有帮助，通过下方的二维码向我打赏吧，帮助我写出更多有用的内容。

2019-02-10 | 响应式