param-pure-default

一款轻量 JS 工具库，解决 JavaScript 原生无法区分「同值默认参数」 完美识别：不传参用默认值 / 手动传入和默认值相同的参数

优势

• 原生 ESM 模块化，适配所有现代前端项目
• 体积极小，零依赖
• 使用简洁，无学习成本
• 支持 Node.js / 浏览器 / Vite / Webpack

安装

npm install param-pure-default

使用示例

import ParamDefaultTrack from 'param-pure-default'

// 新建参数追踪实例
const track = new ParamDefaultTrack()

// 定义函数，绑定默认参数
function showNum(num = track.setDefault(5)) {
  if (track.isDefault()) {
    console.log('当前使用默认值：', num)
  } else {
    console.log('用户手动传入数值：', num)
  }
  // 调用结束重置状态
  track.reset()
}

showNum(10)  // 用户手动传入数值：10
showNum()    // 当前使用默认值：5
showNum(5)   // 用户手动传入数值：5

API 文档

| 方法 | 作用 | | ---- | ---- | | setDefault(value) | 定义函数默认参数，标记默认状态 | | isDefault() | 返回布尔值，判断是否启用默认参数 | | reset() | 重置实例状态，防止多次调用错乱 |

适用场景

• 函数配置项默认值判断
• 接口参数可选值校验
• 工具函数参数优先级判断
• 表单默认填充逻辑区分

License

MIT © 2026 董翔