快速开始

为何使用 Foreslash? 请看这里

安装

npm install foreslash
yarn add foreslash
pnpm install foreslash
bun install foreslash

如果你的网络环境无法访问 npm, 可以指定镜像库安装, 推荐 https://registry.npmmirror.com

npm install foreslash --registry=https://registry.npmmirror.com
yarn add foreslash --registry=https://registry.npmmirror.com

使用

Foreslash 打包为 ESM、CJS、UMD 格式, 可以直接在浏览器与 Node.js 中使用

提示

如果您使用 webpack、vite 等现代打包/构建工具, 那么无需担心格式问题

由于不同的环境存在客观差异(比如只有 Node.js 环境存在原生的 Buffer 对象), 因此不同环境下, 同一个方法的下行为不完全一致

示例

常用的方法有深拷贝 deepClone、柯里化 curry 等

注意

出于性能优化的考量，若无特殊说明，此库的任何方法都不是柯里化的

除非有特殊需求, 推荐使用性能更高、体积更小的 fastClone 替代 deepClone

import { _, curry, randomString, fastClone } from 'foreslash'

// randomString 默认输出的字符为 大小写字母+数字
// 使用 curry 柯里化后, 可以指定第二个参数
// 最终可以组合为一个输出指定数量的随机数字的方法
const randomNumber = curry(randomString)(_, '1234567890')
randomNumber(1) // '1' | '0' | '5'
randomNumber(2) // '26' | '51' | '90'

// fastClone 可以应付大部分场景, 包括循环引用等情况
const obj = { arr: [{ a: 'a' }], map: new Map(), time: new Date(), reg: /test/ig }
obj.map.set(obj, 'val')

const clone = fastClone(obj)
clone.map.get(clone) // 'val'

兼容性

您可以利用 core.js 补全环境 API, 使用 Babel.js 将代码转换为 ES5 等方式使此库可以在几乎所有现代设备上使用

如果出于某些原因不能使用以上手段, 您可以参考以下信息: