es-to-primitive

中文文档
1.3.4发布于 2026/06/26MITTypeScriptCommonJS近 30 天下载 3.8亿

ECMAScript “原始”算法。 提供ES5和ES2015版本.

中文使用文档

对主 Version Badge

github actions coverage dependency status dev dependency status License Downloads

npm badge

ECMAScript “原始”算法。 提供ES5和ES2015版本. 当不同版本的 spec冲突时,默认导出将是抽象操作的最新版本. 备选版本也可在以下表格下提供: es5编号 :es2015 如果您需要特定版本,则导出属性.

示例

var toPrimitive = require('es-to-primitive');
var assert = require('assert');

assert(toPrimitive(function () {}) === String(function () {}));

var date = new Date();
assert(toPrimitive(date) === String(date));

assert(toPrimitive({ valueOf: function () { return 3; } }) === 3);

assert(toPrimitive(['a', 'b', 3]) === String(['a', 'b', 3]));

var sym = Symbol();
assert(toPrimitive(Object(sym)) === sym);

测试

仅仅复制回转, npm install运行 npm test

版本与发布记录

es-to-primitive 共发布 11 个版本,首次发布于 2015/03/19;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.3.4latest2026/06/264 个月前
1.3.32026/06/264 个月前
1.3.22026/06/264 个月前
1.3.12026/06/164 个月前
1.3.02024/11/271.9 年前
1.2.12019/11/096 年前

关于 es-to-primitive 的常见问题

es-to-primitive 是什么?

ECMAScript “原始”算法。 提供ES5和ES2015版本.

如何安装 es-to-primitive?

在项目目录运行 npm install es-to-primitive,或使用 pnpm add / yarn add / bun add。

es-to-primitive 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

es-to-primitive 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

es-to-primitive 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 0.4。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

es-to-primitive 可以商用吗?

es-to-primitive 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

es-to-primitive 的下载量有多少?

根据 npm 官方下载统计,es-to-primitive 在 2026/10/05 – 2026/11/03 这 30 天内被下载 378,973,004 次,日均约 12,632,433 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

es-to-primitive 还在维护吗?

最新版本 1.3.4 发布于 2026/06/26(4 个月前);至今共发布 11 个版本,其中过去 12 个月发布了 4 个;首次发布于 2015/03/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。