返回：唐霜｜书

Objext完全手册

前言

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

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

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

通过keyPath获取、设置数据

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

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

【关注微信公众号：wwwtangshuangnet】

响应式，可以通过$watch监听某个ke【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】yPath

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

【作者：唐霜】

数据版本控制，通过$commit和$re【未经授权禁止转载】未经授权，禁止复制转载。set，可以随时创建快照或恢复数据

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

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

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

数据校验

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

【本文受版权保护】

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

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

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

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

计算属性和依赖收集

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

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

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

著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】

快速上手

本节让你快速使用Objext创建一个对象【作者：唐霜】未经授权，禁止复制转载。，这个对象几乎和普通的js对象的用法一模【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。一样，只不过你可以监听某个属性的变化。

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

安装和使用

objext通过npm进行安装：

npm i objext

安装之后，可以通过不同的方式在项目中引入【本文首发于唐霜的博客】【作者：唐霜】：

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

// 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 },
  ],
})

【原创不易，请尊重版权】原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。【本文受版权保护】

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

你可能会问，这有什么意思呢？单纯这样用当【本文首发于唐霜的博客】【本文首发于唐霜的博客】然没意思，你可以通过$watch方法监听著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】某个属性的变化来实现同步更新：

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

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

这样可以保持两个孩子的年龄同步增长。这是著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.net一种响应式的方法，你可以试试。还有一种响【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。应式的方法，是“计算属性”，它的用法和j【本文首发于唐霜的博客】【转载请注明来源】s原生的计算属性一致。

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

这样，height就是一个计算属性，它依【作者：唐霜】本文版权归作者所有，未经授权不得转载。赖于weight，当weight发生变化原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】的时候，height也发生变化，但是和原转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net生的计算属性相比，objext实例的计算【原创不易，请尊重版权】【本文首发于唐霜的博客】属性使用来缓存，当weight发生变化的【转载请注明来源】【本文首发于唐霜的博客】时候，缓存被更新，获取height时，直【版权所有】唐霜 www.tangshuang.net【未经授权禁止转载】接读取缓存。

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

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

基于keyPath的数据操作

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

【本文首发于唐霜的博客】未经授权，禁止复制转载。

之所以提供这种方式，是因为，我们直接ob原创内容，盗版必究。转载请注明出处：www.tangshuang.netx.body.hands.left会遇到著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。问题，在某些情况下，这个属性节点并不存在【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】，比如obx.body根本就不存在，那么本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。这个操作就会报错，影响程序执行。而通过o【转载请注明来源】【关注微信公众号：wwwtangshuangnet】bjext的keyPath进行操作，则不本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。会影响。

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

$get

通过keyPath获取属性节点。

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

keyPath 要获取的属性节点的key本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】Path

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

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

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

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

当body这个属性节点不存在时，直接返回本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.netundefined，而不会报错。

需要注意的是，$get得到的，不是一个数【本文首发于唐霜的博客】【本文受版权保护】据的原始值，而是objext实例的属性节【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】点，如果该节点对应的原始数据是一个对象，【原创不易，请尊重版权】【转载请注明来源】那么这个节点本身将会是一个objext实转载请注明出处：www.tangshuang.net【转载请注明来源】例，同时具备了一切objext的特性。这著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】涉及到objext的内部层级问题，后文会【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】更深入的讲解。

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

著作权归作者所有，禁止商业用途转载。【本文受版权保护】著作权归作者所有，禁止商业用途转载。

$set

通过keyPath更新或添加一个属性节点未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。。

keyPath 要设置的属性节点的key未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。Path

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

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

value 值

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

【未经授权禁止转载】

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

当节点不存在时，这个节点会被添加。即使b【关注微信公众号：wwwtangshuangnet】【转载请注明来源】ody这个节点不存在，body, han【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】ds, left都会被逐一添加，这样可以本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】保证开发者真正的目的实现，而且还不会报错未经授权，禁止复制转载。【版权所有，侵权必究】。

原创内容，盗版必究。【作者：唐霜】原创内容，盗版必究。【本文受版权保护】

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

著作权归作者所有，禁止商业用途转载。【未经授权禁止转载】【原创不易，请尊重版权】

注意：不要直接在objext实例上添加一著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】个新属性，而要使用$set添加。这样做有【本文受版权保护】转载请注明出处：www.tangshuang.net两个原因：

【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】

1.直接添加属性不具备响应式，即使wat【未经授权禁止转载】未经授权，禁止复制转载。ch，也不会响应；2.直接添加的属性，在【转载请注明来源】本文作者：唐霜，转载请注明出处。使用$put时，会被删掉，因为它不存在于【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】内部的记录中。

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

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

dispatch 是否要触发watche【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.netr，默认为true

【作者：唐霜】

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

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

这样就不会触发通过$watch绑定的wa【本文受版权保护】著作权归作者所有，禁止商业用途转载。tcher。

【本文受版权保护】【原创内容，转载请注明出处】【未经授权禁止转载】

$has

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

keyPath 要判断的属性节点keyP著作权归作者所有，禁止商业用途转载。本文版权归作者所有，未经授权不得转载。ath

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

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

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

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

$update

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

object 将要更新的内容通过一个对象【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】的形式组织起来

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

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

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

通过这种方式可以一次性写入多个属性。当一【转载请注明来源】著作权归作者所有，禁止商业用途转载。个属性不存在时，会自动创建该属性。

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

$put

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

object 要使用的新数据

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

看上去$update和$put很像，但实【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】际上，完全不同，$update简单理解是未经授权，禁止复制转载。【原创不易，请尊重版权】多个$set同时执行，而$put则是现$【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】remove所有已经存在的数据，然后在$未经授权，禁止复制转载。【本文首发于唐霜的博客】set给的数据。

【本文受版权保护】转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

未经授权，禁止复制转载。【转载请注明来源】原创内容，盗版必究。

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

$remove

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

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】

keyPath 要移除的属性节点keyP转载请注明出处：www.tangshuang.net【版权所有，侵权必究】ath

【作者：唐霜】

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

objx.$remove('body.hands')

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

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

响应式

Objext的一个特征是完全的响应式，它本文作者：唐霜，转载请注明出处。【未经授权禁止转载】可以塑造多种响应式方式，而且脱离了任何业【访问 www.tangshuang.net 获取更多精彩内容】【版权所有】唐霜 www.tangshuang.net务场景，是一个纯粹的对象响应式的库。它不【本文首发于唐霜的博客】【版权所有，侵权必究】考虑界面响应的问题，它可以用来解决任何需本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】要观察数据变化而跟随变化的场景，虽然需要【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】自己编写被响应的代码。

计算属性

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

【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】

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

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

创建计算属性

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

创建计算属性超级简单：

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

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

使用计算属性

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。【本文受版权保护】本文版权归作者所有，未经授权不得转载。

未经授权，禁止复制转载。【本文首发于唐霜的博客】

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

计算器中的this

【访问 www.tangshuang.net 获取更多精彩内容】【本文首发于唐霜的博客】

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

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

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

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

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

【本文受版权保护】未经授权，禁止复制转载。原创内容，盗版必究。

当一个计算属性依赖另外一个objext对【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】象的某个属性时，可以使用$depend方【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.net法创建这种依赖关系：

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

这里，objx依赖objx2.age，o著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】bjx2也是一个objext对象，但是o【原创内容，转载请注明出处】本文版权归作者所有，未经授权不得转载。bjx2的age属性发生变化的时候，并不【版权所有】唐霜 www.tangshuang.net【原创不易，请尊重版权】能直接触发objx的weight发生变化原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】，为了解决这个问题，你需要使用$depe【转载请注明来源】本文作者：唐霜，转载请注明出处。nd方法：

objx.$depend(objx)

这需要你手动调用，而不能靠objext自【原创内容，转载请注明出处】原创内容，盗版必究。动实现。

著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】

$watch

$watch方法为objext实例提供一转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】个观察者，对特定keyPath的属性进行【原创内容，转载请注明出处】未经授权，禁止复制转载。观察，当该属性发生变化时，执行传入的回调著作权归作者所有，禁止商业用途转载。【版权所有】唐霜 www.tangshuang.net函数。它的使用非常像angular的$w【作者：唐霜】著作权归作者所有，禁止商业用途转载。atch方法。

keyPath 要观察的属性

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

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

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

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

原创内容，盗版必究。

【未经授权禁止转载】

deep 是否要进行深度观察，当keyP【未经授权禁止转载】原创内容，盗版必究。ath对应的是对象或数组时可以设为tru本文作者：唐霜，转载请注明出处。原创内容，盗版必究。e

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

原创内容，盗版必究。

【未经授权禁止转载】

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

$watch方法是实现objext内部响【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。应式功能的基础方法，因此，它会被广泛用到【转载请注明来源】原创内容，盗版必究。，包括objext内部的响应式实现方式，【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net例如计算属性的自动更新。

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

回调函数fn的参数包括：

【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。

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

【关注微信公众号：wwwtangshuangnet】

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

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

【转载请注明来源】

newValue 新值

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

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

oldValue 老值

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

【本文受版权保护】

其中e，也就是第一个参数，会包含如下信息转载请注明出处：www.tangshuang.net本文版权归作者所有，未经授权不得转载。：

match $watch时的keyPat【转载请注明来源】【转载请注明来源】h

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

【作者：唐霜】

【关注微信公众号：wwwtangshuangnet】

deep $watch时的deep

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

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

path 当前变化的真实节点的keyPa未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。th

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

【关注微信公众号：wwwtangshuangnet】

target 当前objext对象

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

【作者：唐霜】

newValue 新值

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

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

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

oldValue 老值

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

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

stopPropagation 阻止冒泡

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

【本文受版权保护】

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

preventDefault 阻止继续执本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。行其他回调函数

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

【关注微信公众号：wwwtangshuangnet】

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

stack 调用栈

原创内容，盗版必究。

【未经授权禁止转载】

stopPropagation

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

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

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

上面这段代码中，如果body.hands原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。.left被设置为true，那么第一个$【原创不易，请尊重版权】原创内容，盗版必究。watch的回调函数不会被触发。

preventDefault

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

而preventDefault方法也和D未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。OM事件中的preventDefault转载请注明出处：www.tangshuang.net【转载请注明来源】一致，它会阻止剩下的其他回调函数被执行：

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

上面的代码中，如果body.hands.转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.netleft为true，那么第二个回调函数就本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。不会被执行了。

【作者：唐霜】著作权归作者所有，禁止商业用途转载。

特殊符号

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

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

$unwatch

$unwatch是$watch的反函数，原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】用于对某个观察者进行解绑，解绑之后回调函未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。数就不会被调用了。

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

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

$silent

是否开启安静模式更新数据，当安静模式开启转载请注明出处：www.tangshuang.net【未经授权禁止转载】后，所有对数据的修改都不会触发watch【未经授权禁止转载】本文作者：唐霜，转载请注明出处。er。

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

status 使用状态true/fals【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。e，true表示开启安静模式，false【本文受版权保护】转载请注明出处：www.tangshuang.net表示关闭安静模式。

【关注微信公众号：wwwtangshuangnet】

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

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

$isSilent

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

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

数据版本控制

Objext对象的一个特点是可以随意的修本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】改和恢复数据，特别是在一些编辑的时候，你【转载请注明来源】原创内容，盗版必究。可以提供临时保存和恢复的能力。当你放弃进本文作者：唐霜，转载请注明出处。【原创内容，转载请注明出处】行编辑的时候，一个方法就可以让数据恢复到本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。编辑之初的状态。

$commit

创建一个名为tag的快照。

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

tag 快照名称

【转载请注明来源】

objx.$commit('tag1')

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

不能存在同名快照，如果已经存在了同名快照【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。，会被新快照覆盖。

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

$reset

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

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

tag 快照的名称。如果不传的话，直接恢著作权归作者所有，禁止商业用途转载。【本文受版权保护】复到最后一个创建的快照，即使已经存在同名【原创内容，转载请注明出处】【本文首发于唐霜的博客】快照，也会被认为是最后一个。

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

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

reset之后名为tag的快照还是存在的【未经授权禁止转载】【作者：唐霜】，只是当前的数据被设置为快照的内容。

未经授权，禁止复制转载。【本文受版权保护】著作权归作者所有，禁止商业用途转载。

$revert

删除名为tag的快照。

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

tag 快照的名称。如果不传，表示删除上未经授权，禁止复制转载。【未经授权禁止转载】一个创建的快照，规则和reset相同。

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

原创内容，盗版必究。

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

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'

数据锁

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

$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

判断是否被锁死。

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

数据校验

$formulate

设置校验规则。

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

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

【关注微信公众号：wwwtangshuangnet】

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 获取更多精彩内容】本文作者：唐霜，转载请注明出处。 warn中都可以使用this，指向当前【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。context，当前context通过$【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.netbind方法绑定，没有绑定时，表示obj【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。ext对象自身。

$validate

执行校验器。

【作者：唐霜】【关注微信公众号：wwwtangshuangnet】

【关注微信公众号：wwwtangshuangnet】

【未经授权禁止转载】

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

nextData 该keyPath将要使【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。用的值，可选

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

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

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

$strict

status 设为true表示开启，fa未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】lse表示关闭

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

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

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

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

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

$isStrict

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

高级用法

【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。

批量更新

我们可能会一次性更新多个值，普通模式下，【转载请注明来源】【原创不易，请尊重版权】每一次更新，都会触发watcher，一次【本文首发于唐霜的博客】【版权所有】唐霜 www.tangshuang.netwatcher执行，可能带来不同的结果，原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。特别是有依赖性时。一般来讲，我们使用$u【版权所有】唐霜 www.tangshuang.net著作权归作者所有，禁止商业用途转载。pdate进行批量更新，但是，你也可以自【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】己构造批量更新。

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

$start

开启批量更新模式，开启后，watcher【转载请注明来源】【本文首发于唐霜的博客】不会被触发，直到调用$end。

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

$end

完成批量更新，关闭批量更新模式，并且触发【未经授权禁止转载】【转载请注明来源】涉及到的所有watcher。

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

转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】

实例依赖

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

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

$depend

跨实例的属性依赖。

keyPath 当前实例的哪一个keyP著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。ath

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

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

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

target 依赖于另外的哪一个obje【原创内容，转载请注明出处】【原创不易，请尊重版权】xt实例

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

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

dependency 被依赖的实例的那个【原创不易，请尊重版权】原创内容，盗版必究。属性是被依赖的，可选，不传的情况下，会被【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】自动识别

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

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

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

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

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

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

$undepend

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

$bind

target 必须是objext实例，用【作者：唐霜】转载请注明出处：www.tangshuang.net以替代this的指向

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

【本文受版权保护】

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

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

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

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

对比

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

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

$hash

【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。

objx1.$hash === objx2.$hash

静态方法

Objext提供了几个静态方法，可帮助开【关注微信公众号：wwwtangshuangnet】【转载请注明来源】发者快速实现一些功能。

【未经授权禁止转载】著作权归作者所有，禁止商业用途转载。

isEqual

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

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

Objext.isEqual(obj1, obj2)

isEmpty

判断是否为空内容值。所谓空内容，是指“空本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。数组、空对象、空字符串、null、und【原创内容，转载请注明出处】【本文首发于唐霜的博客】efined、NaN”这几种。

本文版权归作者所有，未经授权不得转载。【本文受版权保护】原创内容，盗版必究。

isArray

判断是否为数组。

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

isObject

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

inArray

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

【原创内容，转载请注明出处】【原创不易，请尊重版权】

Objext.inArray(item, items)

inObject

判断一个key是否存在于对象中。只有可枚【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.net举的key被识别。

Object.inObject(key, obj)

isInstanceOf

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

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

Objext.isInstanceOf(obj, ClassObj)

parse

通过keyPath解析获得属性值。

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

assign

通过keyPath设置值。

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

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

clone

克隆一个对象。

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

结语

Objext是一个具有丰富思想的扩展包，【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】它主要用于对数据进行管理的场景，但是它不【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。是纯粹的数据管理工具，而是对碎片数据的扩原创内容，盗版必究。转载请注明出处：www.tangshuang.net展，使得一个数据拥有更丰富的接口，可进行【本文受版权保护】【作者：唐霜】各类操作。

著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。【本文受版权保护】【本文首发于唐霜的博客】

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

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

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

2019-02-10 | 响应式