JavaScript immutable data 模块 immutability-util

MIT
JavaScript
跨平台
2017-06-18
小薇

immutability-util

一个关于 immutable data 处理的 JavaScript 模块,不修改原始值获得一份数据拷贝。使用 ES6 预发重写,并主要集中在性能以及更加好用的 API。

1. 特性

  1. 链式 API 调用,使用非常方便;

  2. 通过 path string 的方式寻找需要修改的节点,简化代码;

  3. 也许可以获得更好的性能;

2. 安装使用

使用 NPM 下载:

npm install -S immutability-util

然后使用方法如下:

const iu = require('immutability-util');
// or 
import iu from 'immutability-util';

// obj need to be mutated.
var obj = {
  a: 1,
  b: 2,
  c: {
    d: 3,
    e: {
      f: [4, 5, 6],
      g: {
        h: 'iu',
      },
    },
    i: {
      j: 'hello, world.',
      k: [7, 8, 9],
      l: [10, 11, 12],
    }
  },
};

// chainable usage.
const state = iu(state)
  .$apply(['a'], v => v + 1)
  .$merge(['c', 'e', 'g'], { m: 'update'})
  .$push(['c', 'e', 'f'], [7, 8, 9])
  .$set(['c', 'i', 'j'], 'hello node 8.')
  .$splice(['c', 'i', 'k'], [1, 1, 10])
  .$unset(['c'], ['d'])
  .$unshift(['c', 'i', 'l'], [13])
  .value(); // then get the mutated copy.
  
// or use path string.
iu(obj).$set('c.i.j', 'hello node 8.').value();

另外,也可以使用以下的方式处理数组路由;

const obj = {
  a: {
    b: [{
      c: [1, 2, 3],
    }, {
      d: 4,
    }, {
      e: [5, 6],
    }]
  }
};
const state = iu(obj)
  .$apply('a.b[1].d', v => v + 1)
  .$push('a.b[0].c', [4])
  .$set('a.b[2].e[0]', 'hello node 8.')
  .value();

3. 可用的 API

当获得了 ImmutabilityUtil 的实例后(引入模块就获得了),可以使用以下的方法:

  • $apply(path, function): 传入一个 function,并且把当前节点作为值传入;

  • $merge(path, object): 类似于数组的 merge 操作;

  • $push(path, array): 类似于数组的 push 操作;

  • $set(path, any): 直接替换对应位置的数据;

  • $splice(path, array_of_arrays): 类似于数组的 splice 方法;

  • $unset(path, array_of_strings): 删除键值;类似于 delete 方法;

  • $unshift(path, array): 类似于数组的 unshift 方法;

然后就可以使用 API value() 得到 immutable 数据拷贝。欢迎 pr 更多的操作方法;

4. Build & Test

通过下面的命令来 buikd 和测试:

npm run build
# run the testcases
npm run test

也可以运行 npm run benchmark 来查看性能对比。

5. License

MIT@hustcc.

加载中

评论(0)

暂无评论

暂无资讯

暂无问答

immutability因React官方出镜之使用总结分享!

引言   之前项目中遇到数据拷贝、引用之间数据层级嵌套过深,拷贝的值相互之间影响的问题,后来引入了immutability-helper,使用过程中的一些总结,跟大家分享下,至于为什么不是immutable...

11/05 08:40
748
0
python basics - Datatypes Collections and Lists

This is one of few coming series that serves as a memo of the common basic syntax when you manipulate python and focus on the basic syntax and built-in data types. In this post,...

2012/10/25 08:47
27
0
OkHttp 2.0

转载自:https://publicobject.com/2014/05/24/okhttp-2-0-rc1/ Adrian, Jake and I have been working on OkHttp 2.0 quite actively for nearly a year, and we're finally ready to share...

2015/04/11 21:09
241
1
String对象不可改变的特性

翻译人员: 铁锚 翻译日期: 2013年11月13日 原文链接: Diagram to show Java String’s Immutability 本文将用3个图片来解释Java中String的不可变性(). 1. 声明String对象 String s = "abcd";...

2016/03/16 23:01
3
1
JVM和面试题

下一代大型JVM语言 常见Java面试题 – 第三部分:重载(overloading)与重写(overriding) 常见Java面试题 – 第四部分:迭代(iteration)和递归(recursion) 常见Java面试题 – 第一部分...

2013/04/09 11:16
387
0
Java并发库(Java Concurrency)

原文地址 译文地址 译者:张坤等 Java并发性和多线程介绍(Java Concurrency / Multithreading Tutorial) 多线程的优点(Multithreading Benefits) 多线程的代价(Multithreading Costs) ...

2016/12/17 19:23
84
0
Scala程序设计

基础篇

2016/08/24 15:11
11
0
在JavaScript中仿真Java的enum

如何在JavaScript中仿真Java的enum

2015/04/24 10:15
328
0
图说JAVA

Top 8 Diagrams for Understanding Java A diagram is sometimes worth 1000 words. The following diagrams are from Java tutorials on Program Creek, they have received the most votes...

2013/10/31 08:57
41
1
String对象不可改变的特性

翻译人员: 铁锚 翻译日期: 2013年11月13日 原文链接: Diagram to show Java String’s Immutability 本文将用3个图片来解释Java中String的不可变性(). 1. 声明String对象 String s = "abcd";...

2016/03/16 22:59
1
1

没有更多内容

加载失败,请刷新页面

返回顶部
顶部