返回：唐霜｜书

Objext完全手册

前言

Objext是一个现代js对象模型，它通【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】过丰富的api扩展js原生模型，使一个对【转载请注明来源】【未经授权禁止转载】象拥有更丰富的操作和数据读写能力，同时可【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net以使之更符合响应式编程的需要。

【转载请注明来源】【未经授权禁止转载】

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

通过keyPath获取、设置数据

【本文受版权保护】

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

响应式，可以通过$watch监听某个ke【转载请注明来源】本文作者：唐霜，转载请注明出处。yPath

【转载请注明来源】

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

数据版本控制，通过$commit和$re【访问 www.tangshuang.net 获取更多精彩内容】【作者：唐霜】set，可以随时创建快照或恢复数据

原创内容，盗版必究。

数据校验

【未经授权禁止转载】

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

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

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

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

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

计算属性和依赖收集

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

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

【转载请注明来源】

上述功能，都被集中于Objext对象一体未经授权，禁止复制转载。【作者：唐霜】，一个看上去像是普通js对象的对象，却可【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】以隐藏上述所有功能。

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

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

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

快速上手

安装和使用

objext通过npm进行安装：

npm i objext

安装之后，可以通过不同的方式在项目中引入【本文受版权保护】【关注微信公众号：wwwtangshuangnet】：

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

// 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>

创建实例

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
})

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

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

这样看来，是不是有点意思了？没关系，我们【未经授权禁止转载】【原创内容，转载请注明出处】后面还有更好玩的东西。

基于keyPath的数据操作

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

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

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

【转载请注明来源】【本文受版权保护】【未经授权禁止转载】

$get

通过keyPath获取属性节点。

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。ng.net【转载请注明来源】未经授权，禁止复制转载。

keyPath 要获取的属性节点的key本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。Path

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

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

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

当body这个属性节点不存在时，直接返回【原创不易，请尊重版权】转载请注明出处：www.tangshuang.netundefined，而不会报错。

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

另外，如果你直接在objext实例上添加【版权所有】唐霜 www.tangshuang.net本文版权归作者所有，未经授权不得转载。一个属性，例如 objx.age = 1【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】0 这种，$get是获取不到这种属性的。【转载请注明来源】【版权所有，侵权必究】这是一个比较忌讳的做法，因此，一定要记住【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。，永远不要直接在objext实例对象上添【版权所有，侵权必究】转载请注明出处：www.tangshuang.net加属性，也不要用delete操作符直接删原创内容，盗版必究。【访问 www.tangshuang.net 获取更多精彩内容】除属性，而要使用objext的实例方法$本文版权归作者所有，未经授权不得转载。【未经授权禁止转载】set和$remove。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】

$set

通过keyPath更新或添加一个属性节点本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。。

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

keyPath 要设置的属性节点的key【作者：唐霜】【未经授权禁止转载】Path

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

【作者：唐霜】

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

原创内容，盗版必究。

value 值

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

【未经授权禁止转载】

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

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

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

objext的特点是响应式的，可以通过$【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】watch对属性的变化进行响应。当你使用【本文首发于唐霜的博客】【原创内容，转载请注明出处】$set进行数据更改或添加时，对应的wa本文作者：唐霜，转载请注明出处。原创内容，盗版必究。tcher会被触发。注意，添加数据也会触【原创内容，转载请注明出处】【访问 www.tangshuang.net 获取更多精彩内容】发watcher哦。

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

原创内容，盗版必究。【原创不易，请尊重版权】

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

dispatch 是否要触发watche原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。r，默认为true

【本文受版权保护】

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

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

$has

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

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

keyPath 要判断的属性节点keyP【未经授权禁止转载】转载请注明出处：www.tangshuang.netath

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

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

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

转载请注明出处：www.tangshua原创内容，盗版必究。【原创不易，请尊重版权】ng.net

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

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

$update

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

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

object 将要更新的内容通过一个对象【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】的形式组织起来

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

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

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

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

通过这种方式可以一次性写入多个属性。当一转载请注明出处：www.tangshuang.net转载请注明出处：www.tangshuang.net个属性不存在时，会自动创建该属性。

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

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

$put

重置整个objext实例的数据为传入的新著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。数据，之前的所有数据会被清空。

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

object 要使用的新数据

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

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

【访问 www.tangshuang.n【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.netet 获取更多精彩内容】

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

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

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

转载请注明出处：www.tangshua转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。ng.net【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

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

上面这段代码执行之后，age没有了，因此【本文受版权保护】著作权归作者所有，禁止商业用途转载。要提前把age取出来。

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

$remove

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

【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】ngnet】原创内容，盗版必究。本文作者：唐霜，转载请注明出处。

keyPath 要移除的属性节点keyP本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】ath

【访问 www.tangshuang.n【本文受版权保护】本文版权归作者所有，未经授权不得转载。et 获取更多精彩内容】

【本文受版权保护】

objx.$remove('body.hands')

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

响应式

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

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

计算属性

计算属性被大规模应用是vue出现的时候，原创内容，盗版必究。原创内容，盗版必究。在vue中，我们需要将普通的数据和计算属【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。性数据分开写，这不是没有道理的，因为计算未经授权，禁止复制转载。著作权归作者所有，禁止商业用途转载。属性意味着不可以手动去修改它的值。在ob原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】jext中也是一样的，如果一个属性是计算【作者：唐霜】【版权所有，侵权必究】属性，就不能通过$set或者赋值的方式去【本文首发于唐霜的博客】未经授权，禁止复制转载。修改它的值。

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

创建计算属性

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

创建计算属性超级简单：

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

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

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

使用计算属性

转载请注明出处：www.tangshua【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。ng.net【原创不易，请尊重版权】【原创不易，请尊重版权】【关注微信公众号：wwwtangshua转载请注明出处：www.tangshuang.net原创内容，盗版必究。ngnet】

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

和普通的对象不同的是，当对属性赋值时，o【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。bjext实例内部是响应式的，赋值时会自著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】动更新计算属性的缓存，因此，在修改属性值未经授权，禁止复制转载。【未经授权禁止转载】之后，依赖它的其他属性值也就跟着变化了。

【作者：唐霜】未经授权，禁止复制转载。【原创不易，请尊重版权】【转载请注明来源】

计算器中的this

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

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

weight计算器中的this指代的就是【转载请注明来源】转载请注明出处：www.tangshuang.netobjx。但是，在一些情况下，这个thi本文作者：唐霜，转载请注明出处。本文版权归作者所有，未经授权不得转载。s可以被bind到其他objext对象上【本文受版权保护】【未经授权禁止转载】。

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

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

【访问 www.tangshuang.n未经授权，禁止复制转载。【本文首发于唐霜的博客】et 获取更多精彩内容】【本文受版权保护】

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

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

objx.$depend(objx)

这需要你手动调用，而不能靠objext自本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】动实现。

本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.n本文作者：唐霜，转载请注明出处。原创内容，盗版必究。et 获取更多精彩内容】【本文受版权保护】

$watch

keyPath 要观察的属性

【转载请注明来源】

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

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

【关注微信公众号：wwwtangshua【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。ngnet】

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

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

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

原创内容，盗版必究。

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

deep 是否要进行深度观察，当keyP【本文受版权保护】【转载请注明来源】ath对应的是对象或数组时可以设为tru【原创不易，请尊重版权】未经授权，禁止复制转载。e

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

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

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

回调函数fn的参数包括：

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

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

【本文受版权保护】

原创内容，盗版必究。

newValue 新值

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

原创内容，盗版必究。

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

oldValue 老值

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

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

原创内容，盗版必究。

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

match $watch时的keyPat【本文首发于唐霜的博客】【本文受版权保护】h

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

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

【作者：唐霜】

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

deep $watch时的deep

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

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

【本文受版权保护】

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

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

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

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

target 当前objext对象

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

转载请注明出处：www.tangshua未经授权，禁止复制转载。【本文首发于唐霜的博客】ng.net

newValue 新值

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

原创内容，盗版必究。

转载请注明出处：www.tangshua本文作者：唐霜，转载请注明出处。【未经授权禁止转载】ng.net

oldValue 老值

【访问 www.tangshuang.n【作者：唐霜】【原创不易，请尊重版权】et 获取更多精彩内容】

stopPropagation 阻止冒泡

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

【本文受版权保护】

preventDefault 阻止继续执【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net行其他回调函数

原创内容，盗版必究。

【本文受版权保护】

stack 调用栈

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

stopPropagation

未经授权，禁止复制转载。转载请注明出处：www.tangshua【本文首发于唐霜的博客】【原创内容，转载请注明出处】ng.net本文版权归作者所有，未经授权不得转载。

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

特殊符号

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

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

$unwatch

$unwatch是$watch的反函数，本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】用于对某个观察者进行解绑，解绑之后回调函【本文首发于唐霜的博客】【未经授权禁止转载】数就不会被调用了。

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

$silent

是否开启安静模式更新数据，当安静模式开启【关注微信公众号：wwwtangshuangnet】【转载请注明来源】后，所有对数据的修改都不会触发watch【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】er。

status 使用状态true/fals本文版权归作者所有，未经授权不得转载。【原创不易，请尊重版权】e，true表示开启安静模式，false原创内容，盗版必究。【本文受版权保护】表示关闭安静模式。

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

【作者：唐霜】

$isSilent

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

【关注微信公众号：wwwtangshua未经授权，禁止复制转载。【原创内容，转载请注明出处】ngnet】【本文首发于唐霜的博客】【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。

数据版本控制

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

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

$commit

创建一个名为tag的快照。

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

tag 快照名称

原创内容，盗版必究。

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

objx.$commit('tag1')

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

不能存在同名快照，如果已经存在了同名快照本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】，会被新快照覆盖。

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

$reset

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

tag 快照的名称。如果不传的话，直接恢【原创不易，请尊重版权】著作权归作者所有，禁止商业用途转载。复到最后一个创建的快照，即使已经存在同名【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】快照，也会被认为是最后一个。

原创内容，盗版必究。

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

reset之后名为tag的快照还是存在的著作权归作者所有，禁止商业用途转载。【本文受版权保护】，只是当前的数据被设置为快照的内容。

$revert

删除名为tag的快照。

tag 快照的名称。如果不传，表示删除上【转载请注明来源】本文作者：唐霜，转载请注明出处。一个创建的快照，规则和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具有继承性，父级属性锁死后，【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】子属性也不能修改。

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

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

$unlock

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

$isLocked

判断是否被锁死。

数据校验

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

$formulate

设置校验规则。

validators 可以是一个数组，也转载请注明出处：www.tangshuang.net原创内容，盗版必究。可以是单个对象，对象内容为：
- path 要校验的keyPath
- determine 一个函数，用以决定是【转载请注明来源】【原创不易，请尊重版权】否要执行当前这个校验规则
- validate 校验器函数，返回tru【版权所有】唐霜 www.tangshuang.net本文作者：唐霜，转载请注明出处。e/false
- message 校验不通过时，会返回一个【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】Error，该message将作为错误信【原创不易，请尊重版权】【版权所有】唐霜 www.tangshuang.net息
- warn 一个函数，用以接受校验失败时返【转载请注明来源】本文作者：唐霜，转载请注明出处。回的error，然后进行下一步处理
- deferred 是否异步校验，为tru未经授权，禁止复制转载。【作者：唐霜】e时表示异步校验，异步校验不会阻塞校验过本文作者：唐霜，转载请注明出处。【本文受版权保护】程，需要在warn中接受error进行后【原创内容，转载请注明出处】【本文受版权保护】续处理
- 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,【版权所有，侵权必究】未经授权，禁止复制转载。 warn中都可以使用this，指向当前【未经授权禁止转载】本文版权归作者所有，未经授权不得转载。context，当前context通过$著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】bind方法绑定，没有绑定时，表示obj【版权所有】唐霜 www.tangshuang.net【本文首发于唐霜的博客】ext对象自身。

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

$validate

执行校验器。

原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

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

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

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

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

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

原创内容，盗版必究。

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

转载请注明出处：www.tangshua【原创内容，转载请注明出处】转载请注明出处：www.tangshuang.netng.net转载请注明出处：www.tangshua【本文受版权保护】【关注微信公众号：wwwtangshuangnet】ng.net

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

$strict

切换严格模式。严格模式下，修改属性值也会【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net进行校验。默认情况下，严格模式是关闭的。著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。在前面的代码中已经有演示，这里不赘述。

status 设为true表示开启，fa【本文受版权保护】本文作者：唐霜，转载请注明出处。lse表示关闭

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

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

原创内容，盗版必究。

【作者：唐霜】

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

$isStrict

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

高级用法

除了以上已经列出的接口和功能，objex本文版权归作者所有，未经授权不得转载。本文版权归作者所有，未经授权不得转载。t还有一些高级用法，使用使会费些脑子，但未经授权，禁止复制转载。【作者：唐霜】是在一些特定场合下可以帮助你实现一些特殊【本文受版权保护】本文版权归作者所有，未经授权不得转载。的要求。

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

批量更新

我们可能会一次性更新多个值，普通模式下，【本文受版权保护】【作者：唐霜】每一次更新，都会触发watcher，一次【作者：唐霜】【版权所有】唐霜 www.tangshuang.netwatcher执行，可能带来不同的结果，本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。特别是有依赖性时。一般来讲，我们使用$u著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。pdate进行批量更新，但是，你也可以自【版权所有】唐霜 www.tangshuang.net【原创内容，转载请注明出处】己构造批量更新。

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

$start

开启批量更新模式，开启后，watcher本文作者：唐霜，转载请注明出处。【作者：唐霜】不会被触发，直到调用$end。

$end

完成批量更新，关闭批量更新模式，并且触发【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。涉及到的所有watcher。

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

实例依赖

普通对象中的this仅会指向自身，但是由【作者：唐霜】本文版权归作者所有，未经授权不得转载。于objext具备响应式能力，因此，有更【转载请注明来源】本文版权归作者所有，未经授权不得转载。丰富的依赖接口。例如objx1依赖obj【作者：唐霜】【转载请注明来源】x2，那么当objx2中的某个发生变化时【版权所有】唐霜 www.tangshuang.net【本文受版权保护】，objx1对应的属性也应该发生变化。

转载请注明出处：www.tangshua【原创不易，请尊重版权】【本文受版权保护】ng.net【作者：唐霜】原创内容，盗版必究。未经授权，禁止复制转载。

$depend

跨实例的属性依赖。

keyPath 当前实例的哪一个keyP本文版权归作者所有，未经授权不得转载。【本文受版权保护】ath

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

原创内容，盗版必究。

target 依赖于另外的哪一个obje【未经授权禁止转载】【未经授权禁止转载】xt实例

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

【本文受版权保护】

【作者：唐霜】

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

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

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

上面的代码表示，objx1.weight【原创内容，转载请注明出处】原创内容，盗版必究。依赖于objx2.age，当objx2.【未经授权禁止转载】原创内容，盗版必究。age发生变化时，objx1.weigh【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】t也会发生变化。

【访问 www.tangshuang.n本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】et 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.n【本文受版权保护】【本文受版权保护】et 获取更多精彩内容】

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

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

$undepend

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

$bind

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

target 必须是objext实例，用【本文首发于唐霜的博客】原创内容，盗版必究。以替代this的指向

【转载请注明来源】

【作者：唐霜】

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

上面代码中的$bind导致objx1中的【关注微信公众号：wwwtangshuangnet】【作者：唐霜】计算属性中的this指代objx2。

【关注微信公众号：wwwtangshua本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。ngnet】【关注微信公众号：wwwtangshua【关注微信公众号：wwwtangshuangnet】【访问 www.tangshuang.net 获取更多精彩内容】ngnet】

对比

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

【原创内容，转载请注明出处】【关注微信公众号：wwwtangshua【未经授权禁止转载】【本文受版权保护】ngnet】【本文首发于唐霜的博客】

$hash

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

objx1.$hash === objx2.$hash

静态方法

【原创不易，请尊重版权】原创内容，盗版必究。原创内容，盗版必究。

isEqual

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

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

Objext.isEqual(obj1, obj2)

isEmpty

判断是否为空内容值。所谓空内容，是指“空未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。数组、空对象、空字符串、null、und【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。efined、NaN”这几种。

isArray

判断是否为数组。

isObject

inArray

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

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

Objext.inArray(item, items)

inObject

判断一个key是否存在于对象中。只有可枚【原创不易，请尊重版权】【原创不易，请尊重版权】举的key被识别。

本文作者：唐霜，转载请注明出处。【未经授权禁止转载】【转载请注明来源】【访问 www.tangshuang.n著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。et 获取更多精彩内容】

Object.inObject(key, obj)

isInstanceOf

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

Objext.isInstanceOf(obj, ClassObj)

parse

通过keyPath解析获得属性值。

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

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

assign

通过keyPath设置值。

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

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

clone

克隆一个对象。

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

结语

Objext是一个具有丰富思想的扩展包，【关注微信公众号：wwwtangshuangnet】【本文受版权保护】它主要用于对数据进行管理的场景，但是它不转载请注明出处：www.tangshuang.net【作者：唐霜】是纯粹的数据管理工具，而是对碎片数据的扩著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。展，使得一个数据拥有更丰富的接口，可进行【作者：唐霜】【作者：唐霜】各类操作。

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

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

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

2019-02-10 | 响应式