Foreslash NPM | npm.io

Foreslash

GitHub top lang NPM Version NPM Downloads NPM package minimized gzipped size

Foreslash 是一个 Javascript 工具库，包含大量实用函数。

Foreslash is a Javascript utilities lib which contains plenty of practical functions.

文档 | Documentation

设计理念 Design Concept

函数式 Functional

此库提供了诸如curry、pipe等函数式编程的方法，但若无特殊说明，此库的任何方法都不是柯里化的。

这是出于性能优化和调试方便的考量。

此库的柯里化方法curry和柯里化占位符_与 ramda 兼容。

不变性 Immutability

若无特殊说明，此库的任何方法都是不可变的，即不会修改传入的原数据，返回值将是一个新的数据。

类型 Type

此库使用 typescript 编写，并使用 jest 和 ts-jest 来单元测试。

安装与使用 Install & Usage

npm install foreslash # 使用 npm 安装
yarn add foreslash # 使用 yarn 安装
pnpm install foreslash # 使用 pnpm 安装

// curry & randomString
import { _, curry, randomString } from 'foreslash'

randomString(3) // 'bcD' or 'T30' or '7c5' or ...

const curriedRanStr = curry(randomString)

const randomABCD = curriedRanStr(_, 'ABCD')
randomABCD(3) // 'BDC' or 'ACD' or 'DBB' or ...

const random1234 = curriedRanStr(_, '1234')
random1234(3) // '431' or '213' or '241' or ...

// fastClone
import { fastClone } from 'foreslash'

const obj = { a: { b: { c: {} } }, map: new Map() }
obj.a.b.c.d = obj
obj.map.set(obj, 'val')

const clone = fastClone(obj)
clone === obj // false
// clone Deep
clone.a.b.c === obj.a.b.c // false
clone.a.b.c.d === clone // true
// clone Map
clone.map === obj.map // false
clone.map.get(clone) === 'val' // true