返回：唐霜｜书

Objext完全手册

前言

未经授权，禁止复制转载。本文作者：唐霜，转载请注明出处。

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

通过keyPath获取、设置数据

【转载请注明来源】

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

原创内容，盗版必究。

【转载请注明来源】

响应式，可以通过$watch监听某个ke【未经授权禁止转载】【未经授权禁止转载】yPath

【转载请注明来源】

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

数据版本控制，通过$commit和$re【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。set，可以随时创建快照或恢复数据

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

原创内容，盗版必究。

数据校验

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

【转载请注明来源】

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

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

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

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

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

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

计算属性和依赖收集

【作者：唐霜】

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

【作者：唐霜】

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

本手册将会介绍上述这些功能如何使用，以及转载请注明出处：www.tangshuang.net【原创内容，转载请注明出处】它们背后的实现原理，通过了解这些原理，可未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。以避免一些错误的使用场景。

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

快速上手

著作权归作者所有，禁止商业用途转载。【转载请注明来源】未经授权，禁止复制转载。原创内容，盗版必究。

安装和使用

objext通过npm进行安装：

npm i objext

安装之后，可以通过不同的方式在项目中引入转载请注明出处：www.tangshuang.net【本文首发于唐霜的博客】：

// ES6
import Objext from 'objext'

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

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

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

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

创建实例

创建一个Objext实例超级简单，只需要著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。传入一个等同结构的js原生对象即可。

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

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

你可能会问，这有什么意思呢？单纯这样用当【原创不易，请尊重版权】【原创内容，转载请注明出处】然没意思，你可以通过$watch方法监听著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。某个属性的变化来实现同步更新：

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

这样可以保持两个孩子的年龄同步增长。这是本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】一种响应式的方法，你可以试试。还有一种响【关注微信公众号：wwwtangshuangnet】【本文受版权保护】应式的方法，是“计算属性”，它的用法和j【原创不易，请尊重版权】【原创不易，请尊重版权】s原生的计算属性一致。

【关注微信公众号：wwwtangshuangnet】原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。

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

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

转载请注明出处：www.tangshuang.net原创内容，盗版必究。【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。

这样看来，是不是有点意思了？没关系，我们【转载请注明来源】【转载请注明来源】后面还有更好玩的东西。

【本文受版权保护】【转载请注明来源】本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。

基于keyPath的数据操作

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

转载请注明出处：www.tangshuang.net【转载请注明来源】【原创不易，请尊重版权】

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

转载请注明出处：www.tangshuang.net【转载请注明来源】【本文首发于唐霜的博客】【关注微信公众号：wwwtangshuangnet】

$get

通过keyPath获取属性节点。

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

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

【作者：唐霜】

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

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

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

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

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

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

本文版权归作者所有，未经授权不得转载。【访问 www.tangshuang.net 获取更多精彩内容】著作权归作者所有，禁止商业用途转载。

$set

通过keyPath更新或添加一个属性节点原创内容，盗版必究。【本文首发于唐霜的博客】。

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

keyPath 要设置的属性节点的key【本文受版权保护】未经授权，禁止复制转载。Path

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

【作者：唐霜】

value 值

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

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

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

转载请注明出处：www.tangshuang.net原创内容，盗版必究。

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

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

注意：不要直接在objext实例上添加一【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。个新属性，而要使用$set添加。这样做有原创内容，盗版必究。【本文首发于唐霜的博客】两个原因：

1.直接添加属性不具备响应式，即使wat【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。ch，也不会响应；2.直接添加的属性，在著作权归作者所有，禁止商业用途转载。【作者：唐霜】使用$put时，会被删掉，因为它不存在于【访问 www.tangshuang.net 获取更多精彩内容】【未经授权禁止转载】内部的记录中。

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

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

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

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

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

【未经授权禁止转载】

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

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

$has

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

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

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

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

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

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

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

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

著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】

$update

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

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

object 将要更新的内容通过一个对象【未经授权禁止转载】【本文首发于唐霜的博客】的形式组织起来

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

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

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

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

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

$put

重置整个objext实例的数据为传入的新【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。数据，之前的所有数据会被清空。

object 要使用的新数据

【作者：唐霜】

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

【未经授权禁止转载】

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

看上去$update和$put很像，但实【原创内容，转载请注明出处】【本文受版权保护】际上，完全不同，$update简单理解是【原创不易，请尊重版权】本文版权归作者所有，未经授权不得转载。多个$set同时执行，而$put则是现$【本文受版权保护】原创内容，盗版必究。remove所有已经存在的数据，然后在$【访问 www.tangshuang.net 获取更多精彩内容】本文作者：唐霜，转载请注明出处。set给的数据。

【作者：唐霜】原创内容，盗版必究。未经授权，禁止复制转载。

在删除阶段，objext实例上所有的属性【本文受版权保护】【转载请注明来源】都会被删除，这也就是为什么不能通过js原【关注微信公众号：wwwtangshuangnet】【关注微信公众号：wwwtangshuangnet】生赋值的形式新增属性的原因之一。

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

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

上面这段代码执行之后，age没有了，因此原创内容，盗版必究。原创内容，盗版必究。要提前把age取出来。

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

$remove

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

【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net

keyPath 要移除的属性节点keyP【访问 www.tangshuang.net 获取更多精彩内容】转载请注明出处：www.tangshuang.netath

原创内容，盗版必究。

objx.$remove('body.hands')

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

响应式

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

【未经授权禁止转载】未经授权，禁止复制转载。转载请注明出处：www.tangshuang.net【原创不易，请尊重版权】

计算属性

计算属性被大规模应用是vue出现的时候，【转载请注明来源】【本文首发于唐霜的博客】在vue中，我们需要将普通的数据和计算属本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】性数据分开写，这不是没有道理的，因为计算转载请注明出处：www.tangshuang.net原创内容，盗版必究。属性意味着不可以手动去修改它的值。在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未经授权，禁止复制转载。原创内容，盗版必究。

使用计算属性

著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】原创内容，盗版必究。

使用计算属性和其他普通属性是一模一样的，本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。不同之处在于，计算属性本身会根据所依赖的【转载请注明来源】【转载请注明来源】属性的变化自动变化。

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

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

计算器中的this

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

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

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

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

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

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

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

当一个计算属性依赖另外一个objext对【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】象的某个属性时，可以使用$depend方【关注微信公众号：wwwtangshuangnet】本文版权归作者所有，未经授权不得转载。法创建这种依赖关系：

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

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

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

objx.$depend(objx)

这需要你手动调用，而不能靠objext自著作权归作者所有，禁止商业用途转载。本文作者：唐霜，转载请注明出处。动实现。

【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】

$watch

$watch方法为objext实例提供一【未经授权禁止转载】【作者：唐霜】个观察者，对特定keyPath的属性进行未经授权，禁止复制转载。未经授权，禁止复制转载。观察，当该属性发生变化时，执行传入的回调本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。函数。它的使用非常像angular的$w原创内容，盗版必究。著作权归作者所有，禁止商业用途转载。atch方法。

keyPath 要观察的属性

原创内容，盗版必究。

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

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

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

【作者：唐霜】

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

原创内容，盗版必究。

【本文受版权保护】

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

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

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

回调函数fn的参数包括：

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

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

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

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

【转载请注明来源】

newValue 新值

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

原创内容，盗版必究。

oldValue 老值

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

原创内容，盗版必究。

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

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

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

【关注微信公众号：wwwtangshuangnet】

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

deep $watch时的deep

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

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

【转载请注明来源】

path 当前变化的真实节点的keyPa原创内容，盗版必究。转载请注明出处：www.tangshuang.netth

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

【作者：唐霜】

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

target 当前objext对象

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

newValue 新值

原创内容，盗版必究。

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

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

oldValue 老值

原创内容，盗版必究。

stopPropagation 阻止冒泡

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

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

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

preventDefault 阻止继续执【版权所有，侵权必究】【未经授权禁止转载】行其他回调函数

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

【转载请注明来源】

stack 调用栈

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

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

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

【本文受版权保护】

stopPropagation

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

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

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

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

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 获取更多精彩内容】【原创不易，请尊重版权】不会被执行了。

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

特殊符号

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

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

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

$unwatch

$unwatch是$watch的反函数，本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】用于对某个观察者进行解绑，解绑之后回调函著作权归作者所有，禁止商业用途转载。未经授权，禁止复制转载。数就不会被调用了。

著作权归作者所有，禁止商业用途转载。【本文首发于唐霜的博客】著作权归作者所有，禁止商业用途转载。【原创不易，请尊重版权】

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

$silent

是否开启安静模式更新数据，当安静模式开启【本文受版权保护】【原创内容，转载请注明出处】后，所有对数据的修改都不会触发watch原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。er。

status 使用状态true/fals【未经授权禁止转载】转载请注明出处：www.tangshuang.nete，true表示开启安静模式，false本文作者：唐霜，转载请注明出处。【未经授权禁止转载】表示关闭安静模式。

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

【本文受版权保护】

【作者：唐霜】

$isSilent

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

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

数据版本控制

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

$commit

创建一个名为tag的快照。

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

tag 快照名称

【作者：唐霜】

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

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

objx.$commit('tag1')

打完一个tag之后，会在内部保存当时的所著作权归作者所有，禁止商业用途转载。【本文受版权保护】有数据，并建立一个快照，后续对objex【未经授权禁止转载】转载请注明出处：www.tangshuang.nett对象的修改，不会影响快照内容。

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

$reset

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

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

tag 快照的名称。如果不传的话，直接恢【访问 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的快照。

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

tag 快照的名称。如果不传，表示删除上著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】一个创建的快照，规则和reset相同。

【未经授权禁止转载】

【关注微信公众号：wwwtangshuangnet】

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

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实未经授权，禁止复制转载。【关注微信公众号：wwwtangshuangnet】例，使它不能进行任何修改。

转载请注明出处：www.tangshuang.net【访问 www.tangshuang.net 获取更多精彩内容】【关注微信公众号：wwwtangshuangnet】

$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

判断是否被锁死。

数据校验

objext支持对数据进行校验，校验的时本文作者：唐霜，转载请注明出处。【本文受版权保护】间点有两种：1.修改数据时；2.调用$v原创内容，盗版必究。本文作者：唐霜，转载请注明出处。alidate方法一次性全部校验。

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

$formulate

设置校验规则。

本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】

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

未经授权，禁止复制转载。【转载请注明来源】

$validate

执行校验器。

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

keyPath 要校验的keyPath，著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。可选，不传的时候，表示一次性执行整个ob本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】jext对象的所有校验器

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

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

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

nextData 该keyPath将要使本文作者：唐霜，转载请注明出处。原创内容，盗版必究。用的值，可选

【作者：唐霜】

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

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

其中，nextData表示提前进行校验，【原创内容，转载请注明出处】著作权归作者所有，禁止商业用途转载。比如，你准备要对某个keyPath进行设【本文首发于唐霜的博客】【访问 www.tangshuang.net 获取更多精彩内容】置新值时，可以提前通过nextData来【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】校验一下，看看是否符合校验规则。

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

$strict

切换严格模式。严格模式下，修改属性值也会著作权归作者所有，禁止商业用途转载。【关注微信公众号：wwwtangshuangnet】进行校验。默认情况下，严格模式是关闭的。【作者：唐霜】【作者：唐霜】在前面的代码中已经有演示，这里不赘述。

status 设为true表示开启，fa本文作者：唐霜，转载请注明出处。【原创不易，请尊重版权】lse表示关闭

【本文受版权保护】

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

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

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

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

$isStrict

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

高级用法

批量更新

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

$start

开启批量更新模式，开启后，watcher【原创不易，请尊重版权】【本文首发于唐霜的博客】不会被触发，直到调用$end。

$end

完成批量更新，关闭批量更新模式，并且触发本文版权归作者所有，未经授权不得转载。本文作者：唐霜，转载请注明出处。涉及到的所有watcher。

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

实例依赖

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

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

$depend

跨实例的属性依赖。

【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。转载请注明出处：www.tangshuang.net

keyPath 当前实例的哪一个keyP著作权归作者所有，禁止商业用途转载。转载请注明出处：www.tangshuang.netath

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

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

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

【转载请注明来源】

target 依赖于另外的哪一个obje原创内容，盗版必究。【原创内容，转载请注明出处】xt实例

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

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

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

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

原创内容，盗版必究。

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

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

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

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

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

【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net

对比

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

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

$hash

objx1.$hash === objx2.$hash

静态方法

isEqual

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

【作者：唐霜】【未经授权禁止转载】【转载请注明来源】本文作者：唐霜，转载请注明出处。

Objext.isEqual(obj1, obj2)

isEmpty

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

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

isArray

判断是否为数组。

isObject

判断是否为纯对象。所谓纯对象，是指非实例【本文受版权保护】【原创不易，请尊重版权】的字面量对象，比如 o = {} 这种。

【关注微信公众号：wwwtangshuangnet】转载请注明出处：www.tangshuang.net

inArray

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

Objext.inArray(item, items)

inObject

Object.inObject(key, obj)

isInstanceOf

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

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

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 获取更多精彩内容】【本文首发于唐霜的博客】展，使得一个数据拥有更丰富的接口，可进行转载请注明出处：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 获取更多精彩内容】【作者：唐霜】未经授权，禁止复制转载。【版权所有】唐霜 www.tangshuang.net【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】

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

2019-02-10 | 响应式