数组
判断
1. all/none/any
FROM
DETAIL：
利用 every、some 包裹一层。
FUNCTION：
const all = (arr, fn = Boolean) => arr.every(fn);
const none = (arr, fn = Boolean) => !arr.some(fn);
const any = (arr, fn = Boolean) => arr.some(fn);
EXAMPLES：
all([4, 2, 3], x => x > 1); // true
all([1, 2, 3]); // true
none([0, 1, 3, 0], x => x == 2); // true
none([0, 0, 0]); // true
any([0, 1, 2, 0], x => x >= 2); // true
any([0, 0, 1, 0]); // true
2. allEqual（全等）
FROM
DETAIL：
判断数组中的所有元素是否相等。将数组中所有参数与第一个数据作对比。
FUNCTION：
const allEqual = arr => arr.every(val => val === arr[0]);
EXAMPLES：
allEqual([1, 2, 3, 4, 5, 6]); // false
allEqual([1, 1, 1, 1]); // true
3. haveSameContents（内容相等）
FROM
DETAIL：
暂无。
FUNCTION：
const haveSameContents = (a, b) => {
for (const v of new Set([...a, ...b]))
if (a.filter(e => e === v).length !== b.filter(e => e === v).length) return false;
return true;
};
EXAMPLES：
haveSameContents([1, 2, 4], [2, 4, 1]); // true
4. includesAll（包含）
FROM
DETAIL：
暂无。
FUNCTION：
const includesAll = (arr, values) => values.every(v => arr.includes(v));
EXAMPLES：
includesAll([1, 2, 3, 4], [1, 4]); // true
includesAll([1, 2, 3, 4], [1, 5]); // false
5. includesAny（包含）
FROM
DETAIL：
可利用 any 方法替代。
const any = (arr, fn = Boolean) => arr.some(fn);
any([2, 9], v => [1, 2, 3, 4].includes(v)); // true
any([8, 9], v => [1, 2, 3, 4].includes(v));
// false
FUNCTION：
const includesAny = (arr, values) => values.some(v => arr.includes(v));
EXAMPLES：
includesAny([1, 2, 3, 4], [2, 9]); // true
includesAny([1, 2, 3, 4], [8, 9]); // false
6. isContainedIn（包含）
FROM
DETAIL：
暂无。
FUNCTION：
const isContainedIn = (a, b) => {
for (const v of new Set(a)) {
if (!b.some(e => e === v) || a.filter(e => e === v).length > b.filter(e => e === v).length)
return false;
}
return true;
};
EXAMPLES：
isContainedIn([1, 4], [2, 4, 1]); // true
7. isSorted（排序）
FROM
DETAIL：
返回 1 为 asc 排序，-1 为 desc 排序，0 未排序。
FUNCTION：
const isSorted = arr => {
let direction = -(arr[0] - arr[1]);
for (let [i, val] of arr.entries()) {
direction = !direction ? -(arr[i - 1] - arr[i]) : direction;
if (i === arr.length - 1) return !direction ? 0 : direction / Math.abs(direction);
else if ((val - arr[i + 1]) * direction > 0) return 0;
}
};
EXAMPLES：
isSorted([0, 1, 2, 2]); // 1
isSorted([4, 3, 2]); // -1
isSorted([4, 3, 5]); // 0
格式转换
1. arrayToCSV
FROM
DETAIL：
对二维数组做了两次 map 映射，内层映射确定分隔符，外层映射添加换行符，针对字符串中双引号作处理。
FUNCTION：
const arrayToCSV = (arr, delimiter = ',') =>
arr
.map(v => v.map(x => (isNaN(x) ? `"${x.replace(/"/g, '""')}"` : x)).join(delimiter))
.join('\n');
EXAMPLES：
arrayToCSV([['a', 'b'], ['c', 'd']]); // '"a","b"\n"c","d"'
arrayToCSV([['a', 'b'], ['c', 'd']], ';'); // '"a";"b"\n"c";"d"'
arrayToCSV([['a', '"b" great'], ['c', 3.1415]]); // '"a","""b"" great"\n"c",3.1415'
2. JSONtoCSV
FROM
DETAIL：
暂无。
FUNCTION：
const JSONtoCSV = (arr, columns, delimiter = ',') =>
[
columns.join(delimiter),
...arr.map(obj =>
columns.reduce(
(acc, key) => `${acc}${!acc.length ? '' : delimiter}"${!obj[key] ? '' : obj[key]}"`,
''
)
)
].join('\n');
EXAMPLES：
JSONtoCSV([{ a: 1, b: 2 }, { a: 3, b: 4, c: 5 }, { a: 6 }, { b: 7 }], ['a', 'b']); // 'a,b\n"1","2"\n"3","4"\n"6",""\n"","7"'
JSONtoCSV([{ a: 1, b: 2 }, { a: 3, b: 4, c: 5 }, { a: 6 }, { b: 7 }], ['a', 'b'], ';'); // 'a;b\n"1";"2"\n"3";"4"\n"6";""\n"";"7"'
3. normalizeLineEndings（换行符）
FROM
DETAIL：
暂无。
FUNCTION：
const normalizeLineEndings = (str, normalized = '\r\n') => str.replace(/\r?\n/g, normalized);
EXAMPLES：
splitLines('This\r\nis a\nmultiline\nstring.\r\n'); // 'This\r\nis a\r\nmultiline\r\nstring.\r\n'
splitLines('This\r\nis a\nmultiline\nstring.\r\n', '\n'); // 'This\nis a\nmultiline\nstring.\n'
生成
1. initialize2DArray（2维）
FROM
DETAIL：
暂无。
FUNCTION：
const initialize2DArray = (w, h, val = null) =>
Array.from({ length: h }).map(() => Array.from({ length: w }).fill(val));
EXAMPLES：
initialize2DArray(2, 2, 0); // [[0,0], [0,0]]
2. initializeNDArray（n维）
FROM
DETAIL：
暂无。
FUNCTION：
const initializeNDArray = (val, ...args) =>
args.length === 0
? val
: Array.from({ length: args[0] }).map(() => initializeNDArray(val, ...args.slice(1)));
EXAMPLES：
initializeNDArray(1, 3); // [1,1,1]
initializeNDArray(5, 2, 2, 2); // [[[5,5],[5,5]],[[5,5],[5,5]]]
3. initializeArrayWithRange（连续范围）
FROM
DETAIL：
暂无。
FUNCTION：
const initializeArrayWithRange = (end, start = 0, step = 1) =>
Array.from({ length: Math.ceil((end - start + 1) / step) }, (v, i) => i * step + start);
EXAMPLES：
initializeArrayWithRange(5); // [0,1,2,3,4,5]
initializeArrayWithRange(7, 3); // [3,4,5,6,7]
initializeArrayWithRange(9, 0, 2); // [0,2,4,6,8]
4. initializeArrayWithRangeRight（连续范围右）
FROM
DETAIL：
暂无。
FUNCTION：
const initializeArrayWithRangeRight = (end, start = 0, step = 1) =>
Array.from({ length: Math.ceil((end + 1 - start) / step) }).map(
(v, i, arr) => (arr.length - i - 1) * step + start
);
EXAMPLES：
initializeArrayWithRangeRight(5); // [5,4,3,2,1,0]
initializeArrayWithRangeRight(7, 3); // [7,6,5,4,3]
initializeArrayWithRangeRight(9, 0, 2); // [8,6,4,2,0]
5. initializeArrayWithValues（连续相同）
FROM
DETAIL：
对 empty 的处理。
FUNCTION：
const initializeArrayWithValues = (n, val = 0) => Array(n).fill(val);
EXAMPLES：
initializeArrayWithValues(5, 2); // [2, 2, 2, 2, 2]
6. mapObject（对象）
FROM
DETAIL：
对 empty 的处理。
FUNCTION：
const mapObject = (arr, fn) =>
arr.reduce((acc, el, i) => {
acc[el] = fn(el, i, arr);
return acc;
}, {});
EXAMPLES：
mapObject([1, 2, 3], a => a * a); // { 1: 1, 2: 4, 3: 9 }
7. reduceSuccessive（累加器）
FROM
DETAIL：
暂无。
FUNCTION：
const reduceSuccessive = (arr, fn, acc) =>
arr.reduce((res, val, i, arr) => (res.push(fn(res.slice(-1)[0], val, i, arr)), res), [acc]);
EXAMPLES：
reduceSuccessive([1, 2, 3, 4, 5, 6], (acc, val) => acc + val, 0); // [0, 1, 3, 6, 10, 15, 21]
分组
1. aperture（指定长度）
FROM
DETAIL：
对二维数组做了两次 map 映射，内层映射确定分隔符，外层映射添加换行符，针对字符串中双引号作处理。
严格的指定长度，不满足时则返回 []。
FUNCTION：
const aperture = (n, arr) =>
n > arr.length
? []
: arr.slice(n - 1).map((v, i) => [...arr.slice(i, i + n - 1), v]);
EXAMPLES：
R.aperture(2, [1, 2, 3, 4]); // [[1, 2], [2, 3], [3, 4]]
R.aperture(3, [1, 2, 3, 4]); // [[1, 2, 3], [2, 3, 4]]
R.aperture(5, [1, 2, 3, 4]); // []
2. chunk（指定长度）
FROM
DETAIL：
相对于 aperture 会尽可能保留长度。
FUNCTION：
const chunk = (arr, size) =>
Array.from({ length: Math.ceil(arr.length / size) }, (v, i) =>
arr.slice(i * size, i * size + size)
);
EXAMPLES：
chunk([1, 2, 3, 4, 5], 2); // [[1,2],[3,4],[5]]
3. chunkIntoN（指定个数）
FROM
DETAIL：
尽可能保持分组中的 size 一致。
FUNCTION：
const chunkIntoN = (arr, n) => {
const size = Math.ceil(arr.length / n);
return Array.from({ length: n }, (v, i) =>
arr.slice(i * size, i * size + size)
);
}
EXAMPLES：
chunkIntoN([1, 2, 3, 4, 5, 6, 7], 4); // [[1,2], [3,4], [5,6], [7]]
4. bifurcate（2 组）
FROM
DETAIL：
根据 filter 分成两组。
FUNCTION：
const bifurcate = (arr, filter) =>
arr.reduce((acc, val, i) => (acc[filter[i] ? 0 : 1].push(val), acc), [[], []]);
EXAMPLES：
bifurcate(['beep', 'boop', 'foo', 'bar'], [true, true, false, true]); // [ ['beep', 'boop', 'bar'], ['foo'] ]
5. bifurcateBy（by）
FROM
DETAIL：
bifurcate 的进阶，更为自由。
FUNCTION：
const bifurcateBy = (arr, fn) =>
arr.reduce((acc, val, i) => (acc[fn(val, i) ? 0 : 1].push(val), acc), [[], []]);
EXAMPLES：
bifurcateBy(['beep', 'boop', 'foo', 'bar'], x => x[0] === 'b'); // [ ["boop", "foo"], ["beep", "bar"]]
分类
1. groupBy（by）
FROM
DETAIL：
与 countBy 实现相似。
FUNCTION：
const groupBy = (arr, fn) =>
arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val, i) => {
acc[val] = (acc[val] || []).concat(arr[i]);
return acc;
}, {});
EXAMPLES：
groupBy([6.1, 4.2, 6.3], Math.floor); // {4: [4.2], 6: [6.1, 6.3]}
groupBy(['one', 'two', 'three'], 'length'); // {3: ['one', 'two'], 5: ['three']}
2. partition
FROM
DETAIL：
仅能分成两组。
FUNCTION：
const partition = (arr, fn) =>
arr.reduce(
(acc, val, i, arr) => {
acc[fn(val, i, arr) ? 0 : 1].push(val);
return acc;
},
[[], []]
);
EXAMPLES：
const users = [{ user: 'barney', age: 36, active: false }, { user: 'fred', age: 40, active: true }];
partition(users, o => o.active); // [[{ 'user': 'fred', 'age': 40, 'active': true }],[{ 'user': 'barney', 'age': 36, 'active': false }]]
3. partitionBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const partitionBy = (arr, fn) =>
arr.reduce(
({ res, last }, v, i, a) => {
const next = fn(v, i, a);
if (next !== last) res.push([v]);
else res[res.length - 1].push(v);
return { res, last: next };
},
{ res: [] }
).res;
EXAMPLES：
const numbers = [1, 1, 3, 3, 4, 5, 5, 5];
partitionBy(numbers, n => n % 2 === 0); // [[1, 1, 3, 3], [4], [5, 5, 5]]
partitionBy(numbers, n => n); // [[1, 1], [3, 3], [4], [5, 5, 5]]
移除
1. compact（falsy）
FROM
DETAIL：
利用了隐式转换概念。移除 “无效” 值。
FUNCTION：
const compact = arr => arr.filter(Boolean);
EXAMPLES：
compact([0, 1, false, 2, '', 3, 'a', 'e' * 23, NaN, 's', 34]); // [ 1, 2, 3, 'a', 's', 34 ]
2. drop（从左开始）
FROM
DETAIL：
暂无。
FUNCTION：
const drop = (arr, n = 1) => arr.slice(n);
EXAMPLES：
drop([1, 2, 3]); // [2,3]
drop([1, 2, 3], 2); // [3]
drop([1, 2, 3], 42); // []
3. dropRight（从右开始）
FROM
DETAIL：
暂无。
FUNCTION：
const dropRight = (arr, n = 1) => arr.slice(0, -n);
EXAMPLES：
dropRight([1, 2, 3]); // [1,2]
dropRight([1, 2, 3], 2); // [1]
dropRight([1, 2, 3], 42); // []
4. dropWhile（从左开始）
FROM
DETAIL：
暂无。
FUNCTION：
const dropWhile = (arr, func) => {
while (arr.length > 0 && !func(arr[0])) arr = arr.slice(1);
return arr;
};
EXAMPLES：
dropWhile([3, 1, 2, 4], n => n < 3); // [1, 2, 4]
5. dropRightWhile（从右开始）
FROM
DETAIL：
暂无。
FUNCTION：
const dropRightWhile = (arr, func) => {
let rightIndex = arr.length;
while (rightIndex-- && !func(arr[rightIndex]));
return arr.slice(0, rightIndex + 1);
};
EXAMPLES：
dropRightWhile([3, 1, 2, 4], n => n < 3); // [3, 1, 2]
6. initial（移除最后）
FROM
DETAIL：
暂无。
FUNCTION：
const initial = arr => arr.slice(0, -1);
EXAMPLES：
initial([1, 2, 3]); // [1,2]
7. tail（移除最前）
FROM
DETAIL：
与 initial 不一致。
FUNCTION：
const tail = arr => (arr.length > 1 ? arr.slice(1) : arr);
EXAMPLES：
tail([1, 2, 3]); // [2,3]
tail([1]); // [1]
8. take（从左）
FROM
DETAIL：
与 initial 不一致。
FUNCTION：
const take = (arr, n = 1) => arr.slice(0, n);
EXAMPLES：
take([1, 2, 3], 5); // [1, 2, 3]
take([1, 2, 3], 0); // []
9. takeRight（从右）
FROM
DETAIL：
暂无。
FUNCTION：
const takeRight = (arr, n = 1) => arr.slice(arr.length - n, arr.length);
EXAMPLES：
takeRight([1, 2, 3], 2); // [ 2, 3 ]
takeRight([1, 2, 3]); // [3]
10. takeWhile（从左）
FROM
DETAIL：
暂无。
FUNCTION：
const takeWhile = (arr, func) => {
for (const [i, val] of arr.entries()) if (func(val)) return arr.slice(0, i);
return arr;
};
EXAMPLES：
takeWhile([1, 2, 3, 4], n => n >= 3); // [1, 2]
11. takeRight（从右）
FROM
DETAIL：
暂无。
FUNCTION：
const takeRightWhile = (arr, func) =>
arr.reduceRight((acc, el) => (func(el) ? acc : [el, ...acc]), []);
EXAMPLES：
takeRightWhile([1, 2, 3, 4], n => n < 3); // [3, 4]
插入
1. insertAt
FROM
DETAIL：
对象展开符。
FUNCTION：
const insertAt = (arr, i, ...v) => {
arr.splice(i + 1, 0, ...v);
return arr;
};
EXAMPLES：
let myArray = [1, 2, 3, 4];
insertAt(myArray, 2, 5); // myArray = [1, 2, 3, 5, 4]
let otherArray = [2, 10];
insertAt(otherArray, 0, 4, 6, 8); // otherArray = [2, 4, 6, 8, 10]
改序
1. forEachRight（反序）
FROM
DETAIL：
slice 浅拷贝。
FUNCTION：
const forEachRight = (arr, callback) =>
arr
.slice()
.reverse()
.forEach(callback);
EXAMPLES：
forEachRight([1, 2, 3, 4], val => console.log(val)); // '4', '3', '2', '1'
2. offset（切片重组）
FROM
DETAIL：
slice 浅拷贝。
FUNCTION：
const offset = (arr, offset) => [...arr.slice(offset), ...arr.slice(0, offset)];
EXAMPLES：
offset([1, 2, 3, 4, 5], 2); // [3, 4, 5, 1, 2]
offset([1, 2, 3, 4, 5], -2); // [4, 5, 1, 2, 3]
2. stableSort（稳定排序）
FROM
DETAIL：
slice 浅拷贝。
FUNCTION：
const stableSort = (arr, compare) =>
arr
.map((item, index) => ({ item, index }))
.sort((a, b) => compare(a.item, b.item) || a.index - b.index)
.map(({ item }) => item);
EXAMPLES：
const arr = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
const stable = stableSort(arr, () => 0); // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
过滤
1. everyNth（取模）
FROM
DETAIL：
暂无。
FUNCTION：
const everyNth = (arr, nth) => arr.filter((e, i) => i % nth === nth - 1);
EXAMPLES：
everyNth([1, 2, 3, 4, 5, 6], 2); // [ 2, 4, 6 ]
2. pull（指定元素）
FROM
DETAIL：
是在原数据上进行修改。
FUNCTION：
const pull = (arr, ...args) => {
let argState = Array.isArray(args[0]) ? args[0] : args;
let pulled = arr.filter(v => !argState.includes(v));
arr.length = 0;
pulled.forEach(v => arr.push(v));
};
EXAMPLES：
let myArray = ['a', 'b', 'c', 'a', 'b', 'c'];
pull(myArray, 'a', 'c'); // myArray = [ 'b', 'b' ]
3. pullAtValue（指定元素）
FROM
DETAIL：
暂无。
FUNCTION：
const pullAtValue = (arr, pullArr) => {
let removed = [],
pushToRemove = arr.forEach((v, i) => (pullArr.includes(v) ? removed.push(v) : v)),
mutateTo = arr.filter((v, i) => !pullArr.includes(v));
arr.length = 0;
mutateTo.forEach(v => arr.push(v));
return removed;
};
EXAMPLES：
let myArray = ['a', 'b', 'c', 'a', 'b', 'c'];
const pulled = pullAtValue(myArray, 'a', 'c'); // myArray = [ 'b', 'b' ] pulled = [ 'a', 'a', 'c', 'c' ]
4. pullAtIndex（指定下标）
FROM
DETAIL：
暂无。
FUNCTION：
const pullAtIndex = (arr, pullArr) => {
let removed = [];
let pulled = arr
.map((v, i) => (pullArr.includes(i) ? removed.push(v) : v))
.filter((v, i) => !pullArr.includes(i));
arr.length = 0;
pulled.forEach(v => arr.push(v));
return removed;
};
EXAMPLES：
let myArray = ['a', 'b', 'c', 'd'];
let pulled = pullAtIndex(myArray, [1, 3]); // myArray = [ 'a', 'c' ] , pulled = [ 'b', 'd' ]
5. pullBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const pullBy = (arr, ...args) => {
const length = args.length;
let fn = length > 1 ? args[length - 1] : undefined;
fn = typeof fn == 'function' ? (args.pop(), fn) : undefined;
let argState = (Array.isArray(args[0]) ? args[0] : args).map(val => fn(val));
let pulled = arr.filter((v, i) => !argState.includes(fn(v)));
arr.length = 0;
pulled.forEach(v => arr.push(v));
};
EXAMPLES：
let myArray = [{ x: 1 }, { x: 2 }, { x: 3 }, { x: 1 }];
pullBy(myArray, [{ x: 1 }, { x: 3 }], o => o.x); // myArray = [{ x: 2 }]
6. reducedFilter（指定 key 及 by）
FROM
DETAIL：
很好的用法。
FUNCTION：
const reducedFilter = (data, keys, fn) =>
data.filter(fn).map(el =>
keys.reduce((acc, key) => {
acc[key] = el[key];
return acc;
}, {})
);
EXAMPLES：
const data = [
{
id: 1,
name: 'john',
age: 24
},
{
id: 2,
name: 'mike',
age: 50
}
];
reducedFilter(data, ['id', 'name'], item => item.age > 24); // [{ id: 2, name: 'mike'}]
7. reject（by）
FROM
DETAIL：
想对于 everyNth 应用更广泛。
FUNCTION：
const reject = (pred, array) => array.filter((...args) => !pred(...args));
EXAMPLES：
reject(x => x % 2 === 0, [1, 2, 3, 4, 5]); // [1, 3, 5]
reject(word => word.length > 4, ['Apple', 'Pear', 'Kiwi', 'Banana']); // ['Pear', 'Kiwi']
8. remove（by）
FROM
DETAIL：
暂无。
FUNCTION：
const remove = (arr, func) =>
Array.isArray(arr)
? arr.filter(func).reduce((acc, val) => {
arr.splice(arr.indexOf(val), 1);
return acc.concat(val);
}, [])
: [];
EXAMPLES：
remove([1, 2, 3, 4], n => n % 2 === 0); // [2, 4]
9. without
FROM
DETAIL：
暂无。
FUNCTION：
const without = (arr, ...args) => arr.filter(v => !args.includes(v));
EXAMPLES：
without([2, 1, 2, 3], 1, 2); // [3]
去重
1. filterNonUnique
FROM
DETAIL：
暂无。
FUNCTION：
const filterNonUnique = arr => arr.filter(i => arr.indexOf(i) === arr.lastIndexOf(i));
EXAMPLES：
filterNonUnique([1, 2, 2, 3, 4, 4, 5]); // [1, 3, 5]
2. filterNonUniqueBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const filterNonUniqueBy = (arr, fn) =>
arr.filter((v, i) => arr.every((x, j) => (i === j) === fn(v, x, i, j)));
EXAMPLES：
filterNonUniqueBy(
[
{ id: 0, value: 'a' },
{ id: 1, value: 'b' },
{ id: 2, value: 'c' },
{ id: 1, value: 'd' },
{ id: 0, value: 'e' }
],
(a, b) => a.id == b.id
); // [ { id: 2, value: 'c' } ]
3. union
FROM
DETAIL：
Set。
FUNCTION：
const union = (a, b) => Array.from(new Set([...a, ...b]));
EXAMPLES：
union([1, 2, 3], [4, 3, 2]); // [1, 2, 3, 4]
4. unionBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const unionBy = (a, b, fn) => {
const s = new Set(a.map(fn));
return Array.from(new Set([...a, ...b.filter(x => !s.has(fn(x)))]));
};
EXAMPLES：
unionBy([2.1], [1.2, 2.3], Math.floor); // [2.1, 1.2]
5. unionWith（with）
FROM
DETAIL：
暂无。
FUNCTION：
const unionWith = (a, b, comp) =>
Array.from(new Set([...a, ...b.filter(x => a.findIndex(y => comp(x, y)) === -1)]));
EXAMPLES：
unionWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0, 3.9], (a, b) => Math.round(a) === Math.round(b)); // [1, 1.2, 1.5, 3, 0, 3.9]
6. uniqueElements
FROM
DETAIL：
暂无。
FUNCTION：
const uniqueElements = arr => [...new Set(arr)];
EXAMPLES：
uniqueElements([1, 2, 2, 3, 4, 4, 5]); // [1, 2, 3, 4, 5]
7. uniqueElementsBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const uniqueElementsBy = (arr, fn) =>
arr.reduce((acc, v) => {
if (!acc.some(x => fn(v, x))) acc.push(v);
return acc;
}, []);
EXAMPLES：
uniqueElementsBy(
[
{ id: 0, value: 'a' },
{ id: 1, value: 'b' },
{ id: 2, value: 'c' },
{ id: 1, value: 'd' },
{ id: 0, value: 'e' }
],
(a, b) => a.id == b.id
); // [ { id: 0, value: 'a' }, { id: 1, value: 'b' }, { id: 2, value: 'c' } ]
8. uniqueElementsByRight（右 by）
FROM
DETAIL：
暂无。
FUNCTION：
const uniqueElementsByRight = (arr, fn) =>
arr.reduceRight((acc, v) => {
if (!acc.some(x => fn(v, x))) acc.push(v);
return acc;
}, []);
EXAMPLES：
uniqueElementsByRight(
[
{ id: 0, value: 'a' },
{ id: 1, value: 'b' },
{ id: 2, value: 'c' },
{ id: 1, value: 'd' },
{ id: 0, value: 'e' }
],
(a, b) => a.id == b.id
); // [ { id: 0, value: 'e' }, { id: 1, value: 'd' }, { id: 2, value: 'c' } ]
查询
1. findLast（元素）
FROM
DETAIL：
暂无。
FUNCTION：
const findLast = (arr, fn) => arr.filter(fn).pop();
EXAMPLES：
findLast([1, 2, 3, 4], n => n % 2 === 1); // 3
2. findLastIndex（下标）
FROM
DETAIL：
暂无。
FUNCTION：
const findLastIndex = (arr, fn) =>
(arr
.map((val, i) => [i, val])
.filter(([i, val]) => fn(val, i, arr))
.pop() || [-1])[0];
EXAMPLES：
findLastIndex([1, 2, 3, 4], n => n % 2 === 1); // 2 (index of the value 3)
findLastIndex([1, 2, 3, 4], n => n === 5); // -1 (default value when not found)
3. head（头部）
FROM
DETAIL：
暂无。
FUNCTION：
const head = arr => (arr && arr.length ? arr[0] : undefined);
EXAMPLES：
head([1, 2, 3]); // 1
head([]); // undefined
head(null); // undefined
head(undefined); // undefined
4. last（尾部）
FROM
DETAIL：
暂无。
FUNCTION：
const last = arr => (arr && arr.length ? arr[arr.length - 1] : undefined);
EXAMPLES：
last([1, 2, 3]); // 3
last([]); // undefined
last(null); // undefined
last(undefined); // undefined
5. nthElement（nth）
FROM
DETAIL：
暂无。
FUNCTION：
const nthElement = (arr, n = 0) => (n === -1 ? arr.slice(n) : arr.slice(n, n + 1))[0];
EXAMPLES：
nthElement(['a', 'b', 'c'], 1); // 'b'
nthElement(['a', 'b', 'b'], -3); // 'a'
6. indexOfAll（所有下标）
FROM
DETAIL：
暂无。
FUNCTION：
const indexOfAll = (arr, val) => arr.reduce((acc, el, i) => (el === val ? [...acc, i] : acc), []);
EXAMPLES：
indexOfAll([1, 2, 3, 1, 2, 3], 1); // [0, 3]
indexOfAll([1, 2, 3], 4); // []
7. longestItem（最长）
FROM
DETAIL：
暂无。
FUNCTION：
const longestItem = (...vals) => vals.reduce((a, x) => (x.length > a.length ? x : a));
EXAMPLES：
longestItem('this', 'is', 'a', 'testcase'); // 'testcase'
longestItem(...['a', 'ab', 'abc']); // 'abc'
longestItem(...['a', 'ab', 'abc'], 'abcd'); // 'abcd'
longestItem([1, 2, 3], [1, 2], [1, 2, 3, 4, 5]); // [1, 2, 3, 4, 5]
longestItem([1, 2, 3], 'foobar'); // 'foobar'
8. maxN（最大）
FROM
DETAIL：
先排序后取个数。
FUNCTION：
const maxN = (arr, n = 1) => [...arr].sort((a, b) => b - a).slice(0, n);
EXAMPLES：
maxN([1, 2, 3]); // [3]
maxN([1, 2, 3], 2); // [3,2]
9. minN（最小）
FROM
DETAIL：
先排序后取个数。
FUNCTION：
const minN = (arr, n = 1) => [...arr].sort((a, b) => a - b).slice(0, n);
EXAMPLES：
minN([1, 2, 3]); // [1]
minN([1, 2, 3], 2); // [1,2]
10. mostFrequent（最频繁）
FROM
DETAIL：
先排序后取个数。
FUNCTION：
const mostFrequent = arr =>
Object.entries(
arr.reduce((a, v) => {
a[v] = a[v] ? a[v] + 1 : 1;
return a;
}, {})
).reduce((a, v) => (v[1] >= a[1] ? v : a), [null, 0])[0];
EXAMPLES：
mostFrequent(['a', 'b', 'a', 'c', 'a', 'a', 'b']); // 'a'
11. reduceWhich（最值）
FROM
DETAIL：
暂无。
FUNCTION：
const reduceWhich = (arr, comparator = (a, b) => a - b) =>
arr.reduce((a, b) => (comparator(a, b) >= 0 ? b : a));
EXAMPLES：
reduceWhich([1, 3, 2]); // 1
reduceWhich([1, 3, 2], (a, b) => b - a); // 3
reduceWhich(
[{ name: 'Tom', age: 12 }, { name: 'Jack', age: 18 }, { name: 'Lucy', age: 9 }],
(a, b) => a.age - b.age
); // {name: "Lucy", age: 9}
12. sortedIndex（位置）
FROM
DETAIL：
暂无。
FUNCTION：
const sortedIndex = (arr, n) => {
const isDescending = arr[0] > arr[arr.length - 1];
const index = arr.findIndex(el => (isDescending ? n >= el : n <= el));
return index === -1 ? arr.length : index;
};
EXAMPLES：
sortedIndex([5, 3, 2, 1], 4); // 1
sortedIndex([30, 50], 40); // 1
13. sortedIndexBy（位置 by）
FROM
DETAIL：
暂无。
FUNCTION：
const sortedIndexBy = (arr, n, fn) => {
const isDescending = fn(arr[0]) > fn(arr[arr.length - 1]);
const val = fn(n);
const index = arr.findIndex(el => (isDescending ? val >= fn(el) : val <= fn(el)));
return index === -1 ? arr.length : index;
};
EXAMPLES：
sortedIndexBy([{ x: 4 }, { x: 5 }], { x: 4 }, o => o.x); // 0
14. sortedIndex（位置从右）
FROM
DETAIL：
暂无。
FUNCTION：
const sortedLastIndex = (arr, n) => {
const isDescending = arr[0] > arr[arr.length - 1];
const index = arr.reverse().findIndex(el => (isDescending ? n <= el : n >= el));
return index === -1 ? 0 : arr.length - index;
};
EXAMPLES：
sortedLastIndex([10, 20, 30, 30, 40], 30); // 4
15. sortedLastIndexBy（位置从右 by）
FROM
DETAIL：
暂无。
FUNCTION：
const sortedLastIndexBy = (arr, n, fn) => {
const isDescending = fn(arr[0]) > fn(arr[arr.length - 1]);
const val = fn(n);
const index = arr
.map(fn)
.reverse()
.findIndex(el => (isDescending ? val <= el : val >= el));
return index === -1 ? 0 : arr.length - index;
};
EXAMPLES：
sortedLastIndexBy([{ x: 4 }, { x: 5 }], { x: 4 }, o => o.x); // 1
统计[频率]
1. countOccurrences（指定）
FROM
DETAIL：
统计数组中某个值出现次数。
FUNCTION：
const countOccurrences = (arr, val) => arr.reduce((a, v) => (v === val ? a + 1 : a), 0);
EXAMPLES：
countOccurrences([1, 1, 2, 1, 2, 3], 1); // 3
2. frequencies（所有）
FROM
DETAIL：
统计数组中某个值出现次数。
FUNCTION：
const frequencies = arr =>
arr.reduce((a, v) => {
a[v] = a[v] ? a[v] + 1 : 1;
return a;
}, {});
EXAMPLES：
frequencies(['a', 'b', 'a', 'c', 'a', 'a', 'b']); // { a: 4, b: 2, c: 1 }
3. countBy（by）
FROM
DETAIL：
更为灵活。
FUNCTION：
const countBy = (arr, fn) =>
arr.map(typeof fn === 'function' ? fn : val => val[fn]).reduce((acc, val) => {
acc[val] = (acc[val] || 0) + 1;
return acc;
}, {});
EXAMPLES：
countBy([6.1, 4.2, 6.3], Math.floor); // {4: 1, 6: 2}
countBy(['one', 'two', 'three'], 'length'); // {3: 2, 5: 1}
countBy(['a', 'b', 'a', 'c', 'a', 'a', 'b'], str => str.slice()); // {a: 4, b: 2, c: 1}
展平
1. flatten（指定深度）
FROM
DETAIL：
暂无。
FUNCTION：
const flatten = (arr, depth = 1) =>
arr.reduce((a, v) => a.concat(depth > 1 && Array.isArray(v) ? flatten(v, depth - 1) : v), []);
EXAMPLES：
flatten([1, [2], 3, 4]); // [1, 2, 3, 4]
flatten([1, [2, [3, [4, 5], 6], 7], 8], 2); // [1, 2, 3, [4, 5], 6, 7, 8]
2. deepFlatten（全部）
FROM
DETAIL：
暂无。
FUNCTION：
const deepFlatten = arr => [].concat(...arr.map(v => (Array.isArray(v) ? deepFlatten(v) : v)));
EXAMPLES：
deepFlatten([1, [2], [[3], 4], 5]); // [1, 2, 3, 4, 5]
差异/相同
1. difference
FROM
DETAIL：
仅暴露了 a 的差异而忽略的 b 的差异。
FUNCTION：
const difference = (a, b) => {
const s = new Set(b);
return a.filter(x => !s.has(x));
};
EXAMPLES：
difference([1, 2, 3], [1, 2, 4]); // [3]
2. differenceBy（by）
FROM
DETAIL：
利用 map 导致返回值仅保留 by 的数据。
FUNCTION：
const differenceBy = (a, b, fn) => {
const s = new Set(b.map(fn));
return a.map(fn).filter(el => !s.has(el));
};
EXAMPLES：
differenceBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [1]
differenceBy([{ x: 2 }, { x: 1 }], [{ x: 1 }], v => v.x); // [2]
3. differenceWith（with）
FROM
DETAIL：
相对于 by 会保留数据信息。
FUNCTION：
const differenceWith = (arr, val, comp) => arr.filter(a => val.findIndex(b => comp(a, b)) === -1);
EXAMPLES：
differenceWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0], (a, b) => Math.round(a) === Math.round(b)); // [1, 1.2]
differenceWith([{ x: 2 }, { x: 1 }], [{ x: 1 }], (a, b) => a.x === b.x); // [{x: 2}]
4. intersection
FROM
DETAIL：
暂无。
FUNCTION：
const intersection = (a, b) => {
const s = new Set(b);
return [...new Set(a)].filter(x => s.has(x));
};
EXAMPLES：
intersection([1, 2, 3], [4, 3, 2]); // [2, 3]
5. intersectionBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const intersectionBy = (a, b, fn) => {
const s = new Set(b.map(fn));
return [...new Set(a)].filter(x => s.has(fn(x)));
};
EXAMPLES：
intersectionBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [2.1]
6. intersectionWith（with）
FROM
DETAIL：
暂无。
FUNCTION：
const intersectionWith = (a, b, comp) => a.filter(x => b.findIndex(y => comp(x, y)) !== -1);
EXAMPLES：
intersectionWith([1, 1.2, 1.5, 3, 0], [1.9, 3, 0, 3.9], (a, b) => Math.round(a) === Math.round(b)); // [1.5, 3, 0]
7. similarity
FROM
DETAIL：
暂无。
FUNCTION：
const similarity = (arr, values) => arr.filter(v => values.includes(v));
EXAMPLES：
similarity([1, 2, 3], [1, 2, 4]); // [1, 2]
8. symmetricDifference
FROM
DETAIL：
暂无。
FUNCTION：
const symmetricDifference = (a, b) => {
const sA = new Set(a),
sB = new Set(b);
return [...a.filter(x => !sB.has(x)), ...b.filter(x => !sA.has(x))];
};
EXAMPLES：
symmetricDifference([1, 2, 3], [1, 2, 4]); // [3, 4]
symmetricDifference([1, 2, 2], [1, 3, 1]); // [2, 2, 3]
9. symmetricDifferenceBy（by）
FROM
DETAIL：
暂无。
FUNCTION：
const symmetricDifferenceBy = (a, b, fn) => {
const sA = new Set(a.map(v => fn(v))),
sB = new Set(b.map(v => fn(v)));
return [...a.filter(x => !sB.has(fn(x))), ...b.filter(x => !sA.has(fn(x)))];
};
EXAMPLES：
symmetricDifferenceBy([2.1, 1.2], [2.3, 3.4], Math.floor); // [ 1.2, 3.4 ]
10. symmetricDifferenceWith（with）
FROM
DETAIL：
暂无。
FUNCTION：
const symmetricDifferenceWith = (arr, val, comp) => [
...arr.filter(a => val.findIndex(b => comp(a, b)) === -1),
...val.filter(a => arr.findIndex(b => comp(a, b)) === -1)
];
EXAMPLES：
symmetricDifferenceWith(
[1, 1.2, 1.5, 3, 0],
[1.9, 3, 0, 3.9],
(a, b) => Math.round(a) === Math.round(b)
); // [1, 1.2, 3.9]
11. uniqueSymmetricDifference
FROM
DETAIL：
暂无。
FUNCTION：
const uniqueSymmetricDifference = (a, b) => [
...new Set([...a.filter(v => !b.includes(v)), ...b.filter(v => !a.includes(v))])
];
EXAMPLES：
uniqueSymmetricDifference([1, 2, 3], [1, 2, 4]); // [3, 4]
uniqueSymmetricDifference([1, 2, 2], [1, 3, 1]); // [2, 3]
排列/组合
1. permutations（排列）
FROM
DETAIL：
随着 arr 长度递增计算消耗指数上升。
FUNCTION：
const permutations = arr => {
if (arr.length <= 2) return arr.length === 2 ? [arr, [arr[1], arr[0]]] : arr;
return arr.reduce(
(acc, item, i) =>
acc.concat(
permutations([...arr.slice(0, i), ...arr.slice(i + 1)]).map(val => [item, ...val])
),
[]
);
};
EXAMPLES：
permutations([1, 33, 5]); // [ [ 1, 33, 5 ], [ 1, 5, 33 ], [ 33, 1, 5 ], [ 33, 5, 1 ], [ 5, 1, 33 ], [ 5, 33, 1 ] ]
2. xProd（组合）
FROM
DETAIL：
暂无。
FUNCTION：
const xProd = (a, b) => a.reduce((acc, x) => acc.concat(b.map(y => [x, y])), []);
EXAMPLES：
xProd([1, 2], ['a', 'b']); // [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
随机
1. sample
FROM
DETAIL：
暂无。
FUNCTION：
const sample = arr => arr[Math.floor(Math.random() * arr.length)];
EXAMPLES：
sample([3, 7, 9, 11]); // 9
2. sampleSize（多个）
FROM
DETAIL：
暂无。
FUNCTION：
const sampleSize = ([...arr], n = 1) => {
let m = arr.length;
while (m) {
const i = Math.floor(Math.random() * m--);
[arr[m], arr[i]] = [arr[i], arr[m]];
}
return arr.slice(0, n);
};
EXAMPLES：
sampleSize([1, 2, 3], 2); // [3,1]
sampleSize([1, 2, 3], 4); // [2,3,1]
3. shuffle（打乱）
FROM
DETAIL：
暂无。
FUNCTION：
const shuffle = ([...arr]) => {
let m = arr.length;
while (m) {
const i = Math.floor(Math.random() * m--);
[arr[m], arr[i]] = [arr[i], arr[m]];
}
return arr;
};
EXAMPLES：
const foo = [1, 2, 3];
shuffle(foo); // [2, 3, 1], foo = [1, 2, 3]
4. weightedSample（权重）
FROM
DETAIL：
暂无。
FUNCTION：
const weightedSample = (arr, weights) => {
let roll = Math.random();
return arr[
weights
.reduce((acc, w, i) => (i === 0 ? [w] : [...acc, acc[acc.length - 1] + w]), [])
.findIndex((v, i, s) => roll >= (i === 0 ? 0 : s[i - 1]) && roll < v)
];
};
EXAMPLES：
weightedSample([3, 7, 9, 11], [0.1, 0.2, 0.6, 0.1]); // 9
覆盖原生
1. shank（splice）
FROM
DETAIL：
暂无。
FUNCTION：
const shank = (arr, index = 0, delCount = 0, ...elements) =>
arr
.slice(0, index)
.concat(elements)
.concat(arr.slice(index + delCount));
EXAMPLES：
const names = ['alpha', 'bravo', 'charlie'];
const namesAndDelta = shank(names, 1, 0, 'delta'); // [ 'alpha', 'delta', 'bravo', 'charlie' ]
const namesNoBravo = shank(names, 1, 1); // [ 'alpha', 'charlie' ]
console.log(names); // ['alpha', 'bravo', 'charlie']
打包（zip）
1. zip（数组）
FROM
DETAIL：
其实与分类比较接近。
FUNCTION：
const zip = (...arrays) => {
const maxLength = Math.max(...arrays.map(x => x.length));
return Array.from({ length: maxLength }).map((_, i) => {
return Array.from({ length: arrays.length }, (_, k) => arrays[k][i]);
});
};
EXAMPLES：
zip(['a', 'b'], [1, 2], [true, false]); // [['a', 1, true], ['b', 2, false]]
zip(['a'], [1, 2], [true, false]); // [['a', 1, true], [undefined, 2, false]]
2. zipObject（对象）
FROM
DETAIL：
暂无。
FUNCTION：
const zipObject = (props, values) =>
props.reduce((obj, prop, index) => ((obj[prop] = values[index]), obj), {});
EXAMPLES：
zipObject(['a', 'b', 'c'], [1, 2]); // {a: 1, b: 2, c: undefined}
zipObject(['a', 'b'], [1, 2, 3]); // {a: 1, b: 2}
3. zipWith（with）
FROM
DETAIL：
暂无。
FUNCTION：
const zipWith = (...array) => {
const fn = typeof array[array.length - 1] === 'function' ? array.pop() : undefined;
return Array.from({ length: Math.max(...array.map(a => a.length)) }, (_, i) =>
fn ? fn(...array.map(a => a[i])) : array.map(a => a[i])
);
};
EXAMPLES：
zipWith([1, 2], [10, 20], [100, 200], (a, b, c) => a + b + c); // [111,222]
zipWith(
[1, 2, 3],
[10, 20],
[100, 200],
(a, b, c) => (a != null ? a : 'a') + (b != null ? b : 'b') + (c != null ? c : 'c')
); // [111, 222, '3bc']
4. unzip
FROM
DETAIL：
暂无。
FUNCTION：
const unzip = arr =>
arr.reduce(
(acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
Array.from({
length: Math.max(...arr.map(x => x.length))
}).map(x => [])
);
EXAMPLES：
unzip([['a', 1, true], ['b', 2, false]]); // [['a', 'b'], [1, 2], [true, false]]
unzip([['a', 1, true], ['b', 2]]); // [['a', 'b'], [1, 2], [true]]
5. unzipWith（with）
FROM
DETAIL：
暂无。
FUNCTION：
const unzipWith = (arr, fn) =>
arr
.reduce(
(acc, val) => (val.forEach((v, i) => acc[i].push(v)), acc),
Array.from({
length: Math.max(...arr.map(x => x.length))
}).map(x => [])
)
.map(val => fn(...val));
EXAMPLES：
unzipWith([[1, 10, 100], [2, 20, 200]], (...args) => args.reduce((acc, v) => acc + v, 0)); // [3, 30, 300]
待整理
1. toHash
FROM
DETAIL：
可能不是那么好理解。
FUNCTION：
const toHash = (object, key) =>
Array.prototype.reduce.call(
object,
(acc, data, index) => ((acc[!key ? index : data[key]] = data), acc),
{}
);
EXAMPLES：
toHash([4, 3, 2, 1]); // { 0: 4, 1: 3, 2: 2, 3: 1 }
toHash([{ a: 'label' }], 'a'); // { label: { a: 'label' } }
// A more in depth example:
let users = [{ id: 1, first: 'Jon' }, { id: 2, first: 'Joe' }, { id: 3, first: 'Moe' }];
let managers = [{ manager: 1, employees: [2, 3] }];
// We use function here because we want a bindable reference, but a closure referencing the hash would work, too.
managers.forEach(
manager =>
(manager.employees = manager.employees.map(function(id) {
return this[id];
}, toHash(users, 'id')))
);
managers; // [ { manager:1, employees: [ { id: 2, first: "Joe" }, { id: 3, first: "Moe" } ] } ]
低意义
1. juxt（高阶）
FROM
DETAIL：
除了秀操作没想到别的。
FUNCTION：
const juxt = (...fns) => (...args) => [...fns].map(fn => [...args].map(fn));
EXAMPLES：
juxt(
x => x + 1,
x => x - 1,
x => x * 10
)(1, 2, 3); // [[2,3,4],[0,1,2],[10,20,30]]
juxt(
s => s.length,
s => s.split(" ").join("-")
)("30 seconds of code"); // [[18],['30-seconds-of-code']]