返回：唐霜｜书

Objext完全手册

前言

Objext是一个现代js对象模型，它通本文版权归作者所有，未经授权不得转载。著作权归作者所有，禁止商业用途转载。过丰富的api扩展js原生模型，使一个对【关注微信公众号：wwwtangshuangnet】【本文首发于唐霜的博客】象拥有更丰富的操作和数据读写能力，同时可【原创不易，请尊重版权】转载请注明出处：www.tangshuang.net以使之更符合响应式编程的需要。

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

【访问 www.tangshuang.net 获取更多精彩内容】原创内容，盗版必究。

通过keyPath获取、设置数据

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

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

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

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

响应式，可以通过$watch监听某个ke本文作者：唐霜，转载请注明出处。著作权归作者所有，禁止商业用途转载。yPath

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

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

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

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

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

【未经授权禁止转载】

数据校验

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

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

【作者：唐霜】

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

原创内容，盗版必究。

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

计算属性和依赖收集

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

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

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

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

快速上手

本节让你快速使用Objext创建一个对象本文版权归作者所有，未经授权不得转载。【原创内容，转载请注明出处】，这个对象几乎和普通的js对象的用法一模【原创不易，请尊重版权】本文作者：唐霜，转载请注明出处。一样，只不过你可以监听某个属性的变化。

安装和使用

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

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

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

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

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

这样可以保持两个孩子的年龄同步增长。这是【原创内容，转载请注明出处】【关注微信公众号：wwwtangshuangnet】一种响应式的方法，你可以试试。还有一种响【未经授权禁止转载】【访问 www.tangshuang.net 获取更多精彩内容】应式的方法，是“计算属性”，它的用法和j原创内容，盗版必究。原创内容，盗版必究。s原生的计算属性一致。

【访问 www.tangshuang.net 获取更多精彩内容】【转载请注明来源】【本文受版权保护】

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

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

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

这样看来，是不是有点意思了？没关系，我们【访问 www.tangshuang.net 获取更多精彩内容】未经授权，禁止复制转载。后面还有更好玩的东西。

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

基于keyPath的数据操作

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

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

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

$get

通过keyPath获取属性节点。

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

keyPath 要获取的属性节点的key【关注微信公众号：wwwtangshuangnet】著作权归作者所有，禁止商业用途转载。Path

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

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

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

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

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

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

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

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

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

$set

通过keyPath更新或添加一个属性节点未经授权，禁止复制转载。【未经授权禁止转载】。

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

keyPath 要设置的属性节点的key【访问 www.tangshuang.net 获取更多精彩内容】【原创不易，请尊重版权】Path

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

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

value 值

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

原创内容，盗版必究。

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

当节点不存在时，这个节点会被添加。即使b著作权归作者所有，禁止商业用途转载。【访问 www.tangshuang.net 获取更多精彩内容】ody这个节点不存在，body, han【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】ds, left都会被逐一添加，这样可以著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。保证开发者真正的目的实现，而且还不会报错本文作者：唐霜，转载请注明出处。【本文首发于唐霜的博客】。

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

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

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

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

1.直接添加属性不具备响应式，即使wat转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。ch，也不会响应；2.直接添加的属性，在著作权归作者所有，禁止商业用途转载。原创内容，盗版必究。使用$put时，会被删掉，因为它不存在于转载请注明出处：www.tangshuang.net原创内容，盗版必究。内部的记录中。

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

而另外一种情况是，如果你想在单个操作中，【本文受版权保护】著作权归作者所有，禁止商业用途转载。仅仅更新属性值，而不触发watcher怎本文版权归作者所有，未经授权不得转载。【本文首发于唐霜的博客】么办呢？$set的第三个参数设置为fal转载请注明出处：www.tangshuang.net【本文受版权保护】se即可：

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

dispatch 是否要触发watche原创内容，盗版必究。【未经授权禁止转载】r，默认为true

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

【转载请注明来源】

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

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

这样就不会触发通过$watch绑定的wa转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】tcher。

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

$has

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

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

keyPath 要判断的属性节点keyP【作者：唐霜】【作者：唐霜】ath

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

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

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

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

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

$update

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

object 将要更新的内容通过一个对象【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。的形式组织起来

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

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

原创内容，盗版必究。

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

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

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

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

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

$put

重置整个objext实例的数据为传入的新【原创内容，转载请注明出处】【本文受版权保护】数据，之前的所有数据会被清空。

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

object 要使用的新数据

【本文受版权保护】

【关注微信公众号：wwwtangshuangnet】

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

【转载请注明来源】【本文首发于唐霜的博客】本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。

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

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

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

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

$remove

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

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

keyPath 要移除的属性节点keyP【版权所有】唐霜 www.tangshuang.net【本文受版权保护】ath

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

【转载请注明来源】

原创内容，盗版必究。

objx.$remove('body.hands')

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

响应式

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

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

计算属性

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

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

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

创建计算属性

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

创建计算属性超级简单：

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

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.tangshuang.net【本文受版权保护】【关注微信公众号：wwwtangshuangnet】【原创内容，转载请注明出处】

使用计算属性

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

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

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

和普通的对象不同的是，当对属性赋值时，o本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】bjext实例内部是响应式的，赋值时会自【原创不易，请尊重版权】【作者：唐霜】动更新计算属性的缓存，因此，在修改属性值原创内容，盗版必究。【未经授权禁止转载】之后，依赖它的其他属性值也就跟着变化了。

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

计算器中的this

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

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

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方法会使【关注微信公众号：wwwtangshuangnet】未经授权，禁止复制转载。所有的计算器的this都换绑，而不是只换【版权所有，侵权必究】【原创不易，请尊重版权】绑一个计算器。因此，在使用$bind时，【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】也要理解它的运作规律才使用。

当一个计算属性依赖另外一个objext对著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。象的某个属性时，可以使用$depend方著作权归作者所有，禁止商业用途转载。【作者：唐霜】法创建这种依赖关系：

【作者：唐霜】【原创不易，请尊重版权】【本文首发于唐霜的博客】

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

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

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

objx.$depend(objx)

这需要你手动调用，而不能靠objext自本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】动实现。

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

$watch

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

keyPath 要观察的属性

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

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

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

原创内容，盗版必究。

【未经授权禁止转载】

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

deep 是否要进行深度观察，当keyP【关注微信公众号：wwwtangshuangnet】【版权所有】唐霜 www.tangshuang.netath对应的是对象或数组时可以设为tru【本文首发于唐霜的博客】未经授权，禁止复制转载。e

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

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

【未经授权禁止转载】

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

$watch方法是实现objext内部响【作者：唐霜】【访问 www.tangshuang.net 获取更多精彩内容】应式功能的基础方法，因此，它会被广泛用到【关注微信公众号：wwwtangshuangnet】【原创不易，请尊重版权】，包括objext内部的响应式实现方式，【作者：唐霜】本文作者：唐霜，转载请注明出处。例如计算属性的自动更新。

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

回调函数fn的参数包括：

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

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

【本文受版权保护】

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

【本文受版权保护】

newValue 新值

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

【本文受版权保护】

oldValue 老值

【作者：唐霜】

【本文受版权保护】

【未经授权禁止转载】

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

【本文受版权保护】【本文首发于唐霜的博客】

match $watch时的keyPat【转载请注明来源】转载请注明出处：www.tangshuang.neth

【本文受版权保护】

deep $watch时的deep

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

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

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

path 当前变化的真实节点的keyPa【未经授权禁止转载】本文作者：唐霜，转载请注明出处。th

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

target 当前objext对象

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

newValue 新值

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

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

oldValue 老值

【未经授权禁止转载】

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

stopPropagation 阻止冒泡

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

原创内容，盗版必究。

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

preventDefault 阻止继续执原创内容，盗版必究。本文作者：唐霜，转载请注明出处。行其他回调函数

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

stack 调用栈

【本文受版权保护】

【关注微信公众号：wwwtangshuangnet】

stopPropagation

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

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

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

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

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

$silent

是否开启安静模式更新数据，当安静模式开启【访问 www.tangshuang.net 获取更多精彩内容】本文版权归作者所有，未经授权不得转载。后，所有对数据的修改都不会触发watch转载请注明出处：www.tangshuang.net本文作者：唐霜，转载请注明出处。er。

status 使用状态true/fals【版权所有，侵权必究】【关注微信公众号：wwwtangshuangnet】e，true表示开启安静模式，false【本文受版权保护】【原创不易，请尊重版权】表示关闭安静模式。

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

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

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

原创内容，盗版必究。

$isSilent

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

数据版本控制

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

$commit

创建一个名为tag的快照。

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

tag 快照名称

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

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

【转载请注明来源】

objx.$commit('tag1')

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

不能存在同名快照，如果已经存在了同名快照原创内容，盗版必究。未经授权，禁止复制转载。，会被新快照覆盖。

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

$reset

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

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

tag 快照的名称。如果不传的话，直接恢本文版权归作者所有，未经授权不得转载。原创内容，盗版必究。复到最后一个创建的快照，即使已经存在同名【原创内容，转载请注明出处】本文作者：唐霜，转载请注明出处。快照，也会被认为是最后一个。

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

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

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

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

reset之后名为tag的快照还是存在的本文作者：唐霜，转载请注明出处。【作者：唐霜】，只是当前的数据被设置为快照的内容。

$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实本文作者：唐霜，转载请注明出处。【本文受版权保护】例，使它不能进行任何修改。

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

$lock

锁死数据。

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

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

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

objext具有继承性，父级属性锁死后，【本文首发于唐霜的博客】未经授权，禁止复制转载。子属性也不能修改。

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

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

$unlock

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

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

$isLocked

判断是否被锁死。

数据校验

objext支持对数据进行校验，校验的时【本文受版权保护】著作权归作者所有，禁止商业用途转载。间点有两种：1.修改数据时；2.调用$v【本文首发于唐霜的博客】【原创不易，请尊重版权】alidate方法一次性全部校验。

$formulate

设置校验规则。

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

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

$validate

执行校验器。

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

【转载请注明来源】

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

【关注微信公众号：wwwtangshuangnet】

nextData 该keyPath将要使著作权归作者所有，禁止商业用途转载。【原创内容，转载请注明出处】用的值，可选

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

【作者：唐霜】

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

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

【本文受版权保护】原创内容，盗版必究。【转载请注明来源】

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

$strict

切换严格模式。严格模式下，修改属性值也会【访问 www.tangshuang.net 获取更多精彩内容】【访问 www.tangshuang.net 获取更多精彩内容】进行校验。默认情况下，严格模式是关闭的。著作权归作者所有，禁止商业用途转载。【本文受版权保护】在前面的代码中已经有演示，这里不赘述。

status 设为true表示开启，fa转载请注明出处：www.tangshuang.net著作权归作者所有，禁止商业用途转载。lse表示关闭

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

原创内容，盗版必究。

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

$isStrict

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

高级用法

除了以上已经列出的接口和功能，objex本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。t还有一些高级用法，使用使会费些脑子，但转载请注明出处：www.tangshuang.net未经授权，禁止复制转载。是在一些特定场合下可以帮助你实现一些特殊【关注微信公众号：wwwtangshuangnet】本文作者：唐霜，转载请注明出处。的要求。

批量更新

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

本文作者：唐霜，转载请注明出处。【关注微信公众号：wwwtangshuangnet】

$start

原创内容，盗版必究。本文版权归作者所有，未经授权不得转载。未经授权，禁止复制转载。【转载请注明来源】

$end

完成批量更新，关闭批量更新模式，并且触发【本文首发于唐霜的博客】转载请注明出处：www.tangshuang.net涉及到的所有watcher。

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

上面的代码中，我们执行了两次objx.n本文作者：唐霜，转载请注明出处。原创内容，盗版必究。ame赋值操作，但是由于处于批量更新模式【本文首发于唐霜的博客】【本文首发于唐霜的博客】中，最终objx.name的watche本文作者：唐霜，转载请注明出处。【访问 www.tangshuang.net 获取更多精彩内容】r只会被触发一次。

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

实例依赖

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

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

$depend

跨实例的属性依赖。

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

keyPath 当前实例的哪一个keyP本文作者：唐霜，转载请注明出处。未经授权，禁止复制转载。ath

【作者：唐霜】

target 依赖于另外的哪一个obje本文作者：唐霜，转载请注明出处。【作者：唐霜】xt实例

原创内容，盗版必究。

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

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

dependency 被依赖的实例的那个原创内容，盗版必究。【未经授权禁止转载】属性是被依赖的，可选，不传的情况下，会被【本文受版权保护】【原创内容，转载请注明出处】自动识别

【本文受版权保护】

【关注微信公众号：wwwtangshuangnet】

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

上面的代码表示，objx1.weight未经授权，禁止复制转载。【访问 www.tangshuang.net 获取更多精彩内容】依赖于objx2.age，当objx2.【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】age发生变化时，objx1.weigh原创内容，盗版必究。【关注微信公众号：wwwtangshuangnet】t也会发生变化。

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

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

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

$undepend

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

$bind

修改当前objext实例的context【原创内容，转载请注明出处】【未经授权禁止转载】。在objext实例的计算器、校验器等函未经授权，禁止复制转载。本文版权归作者所有，未经授权不得转载。数中的this，将会使用$bind的参数本文作者：唐霜，转载请注明出处。本文作者：唐霜，转载请注明出处。取代。

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

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中的转载请注明出处：www.tangshuang.net【关注微信公众号：wwwtangshuangnet】计算属性中的this指代objx2。

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

要使得解除绑定关系，恢复this指代当前【本文首发于唐霜的博客】本文作者：唐霜，转载请注明出处。实例，$bind参数为null即可。

对比

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

$hash

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

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

objx1.$hash === objx2.$hash

静态方法

Objext提供了几个静态方法，可帮助开原创内容，盗版必究。【原创不易，请尊重版权】发者快速实现一些功能。

isEqual

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

Objext.isEqual(obj1, obj2)

isEmpty

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

isArray

判断是否为数组。

isObject

inArray

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

【转载请注明来源】【原创不易，请尊重版权】【访问 www.tangshuang.net 获取更多精彩内容】【原创内容，转载请注明出处】

Objext.inArray(item, items)

inObject

判断一个key是否存在于对象中。只有可枚【转载请注明来源】本文版权归作者所有，未经授权不得转载。举的key被识别。

Object.inObject(key, obj)

isInstanceOf

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

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【本文受版权保护】【作者：唐霜】

基于Objext，你可以扩展出更有意思的著作权归作者所有，禁止商业用途转载。著作权归作者所有，禁止商业用途转载。工具出来，它提供了一个思想，让你可以对自本文版权归作者所有，未经授权不得转载。【关注微信公众号：wwwtangshuangnet】己的对象数据为所欲为。

未经授权，禁止复制转载。未经授权，禁止复制转载。转载请注明出处：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 | 响应式