@6pm/tuple 中文文档教程

Question

6pm Tuple

@6pm/tuple 包将元组实现为不可变的值数组，其中 额外的保证，即每个值的组合都由一个 单例元组实例。

因为单例的性质，这些元组适合做identity 比较 (tuple1 === tuple2)，并存储在 Set 和 WeakSet 中，作为 Map 和 WeakMap 的键值。

Installing

npm install @6pm/tuple

Running the test suite

从 @6pm/tuple 包中。

• browser tests:

npm test

并按照提供的说明

• cli tests:

npm install -g mocha
mocha

• ci tests

npm test ci

• coverage test

npm run cover

Usage

通过以下任一方式提供值数组来创建元

Tuple.for([ a, b, c ]);

：

var tuple = Tuple.any([ 1, null, Infinity ]);

Tuple.any([ 1, null, Infinity ]) === tuple; // true

组 他们的成员被默默地忽略了。

var tuple = Tuple.any([ 1, 2, 3 ]);
tuple[1] = -1;

tuple[1]; // 2

for or any?

这两种方法的不同之处在于 any() 允许原始值，而 for() 只允许符合条件的值作为 Map 键，加上 null 和 <代码>未定义。 然而，原始值是有代价的，所以应该与 警告！

这两种方法共享相同的元组空间，例如：

var a = {}, b = {};

Tuple.for([ a, b ]) === Tuple.any([ a, b ]); // true

any

这种分裂的原因是目前没有通用的机制来 允许对 JavaScript 中的值进行弱引用（仅通过键，通过 WeakMap）， 所以使用 any() 是有代价的——每个不同的原始值在一个 元组将使用垃圾收集器无法回收的内存。

这意味着 any() 应该谨慎使用，通常是当 可能提供的原语是有界的并且相对较小，否则这 打开内存泄漏的可能性。

for

使用 for() 不会泄漏内存，如果结果的任何元素 元组有资格进行垃圾收集，然后元组本身变成 无法访问，一旦没有直接访问，它最终也会被垃圾收集 存在参考。