# lie 中文文档

规范地址：https://npmcn.com/package/lie/

版本：3\.3\.0
npm 元数据更新时间：2022-06-19T12:12:59.918Z
中文译文更新时间：2026-11-05T16:12:54.785Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/lie
原文对照：https://npmcn.com/package/lie/?lang=original
项目主页：https://github.com/calvinmetcalf/lie#readme
源码仓库：https://github.com/calvinmetcalf/lie

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：59.1 kB，11 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2013-08-16T14:26:52.426Z
- 最新版本发布：2018-03-06T14:54:08.384Z
- 近 30 天下载量：239017647（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：47（近 12 个月 0 个）

## 中文简介

基本但能兑现的承诺

## 安装

```sh
npm install lie
```

也可以使用：`pnpm add lie`、`yarn add lie`、`bun add lie`

## README

# 谎言

 [![Promises/A+ logo](http://promises-aplus.github.com/promises-spec/assets/logo-small.png "Promises/A+ 1.1 compliant")](http://promises-aplus.github.com/promises-spec)\[\[建设状况\](https://travis-ci.org/calvinmetcalf/lie.svg)\](https://travis-ci.org/calvinmetcalf/lie)

谎言是一个小的, 执行承诺的图书馆 [承诺/A+规格](http://promises-aplus.github.com/promises-spec/) (版本1.1).

本来是叉子 [鲁本·韦尔博赫](https://github.com/RubenVerborgh)是因为 [滥交](https://github.com/RubenVerborgh/promiscuous),随着2.6版成为了叉子 [答应我](https://github.com/cburgmer/ayepromise) 以 [克里斯·伯克默](https://github.com/cburgmer)。 。 。 .

```bash
npm install lie

```

```javascript
var Promise = require('lie');
// or use the pollyfill
require('lie/polyfill');
```

## 使用量

要么用这个 [浏览器](http://browserify.org/) (建议)或从 dist 文件夹中抓取一个文件 :

-   laid.js/lie.min.js将“承诺”作为UMD模块或从全球范围披露,取决于是否有CJS或AMD装载器.
-   laid.polyfill.js/lie.polyfill.min.js 只有在还没有定义(不是UMD)的情况下,才会在全球范围添加"保证".

## API 密码

执行标准ES6 api:

```js
new Promise(function(resolve, reject){
    doSomething(function(err, result) {
        if (err) {
            reject(err);
        } else {
            resolve(result);
        }
    });
}).then(function (value) {
    //on success
}, function (reason) {
    //on error
}).catch(function (reason) {
    //shortcut for error handling
});

Promise.all([
    //array of promises or values
]).then(function ([/* array of results */]));

Promise.race([
    //array of promises or values
]);
// either resolves or rejects depending on the first value to do so
```

## 未经处理的拒绝

在Node.js,谎言发出一个 `unhandledRejection` 如果一个被拒绝的诺言没有被抓住, 符合 [怎么样的io.js](https://iojs.org/api/process.html#process_event_unhandledrejection)。这使得它可以在节点Js和浏览器中起到承诺 shim的作用.

## 常见问题

### lie 是什么？

基本但能兑现的承诺

### 如何安装 lie？

在项目目录运行 npm install lie，或使用 pnpm add / yarn add / bun add。

### lie 支持 TypeScript 吗？

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

### lie 支持 ESM 还是 CommonJS？

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

### lie 可以商用吗？

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

### lie 的下载量有多少？

根据 npm 官方下载统计，lie 在 2026/10/05 – 2026/11/03 这 30 天内被下载 239,017,647 次，日均约 7,967,255 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### lie 还在维护吗？

最新版本 3\.3\.0 发布于 2018/03/06（8 年前）；至今共发布 47 个版本，其中过去 12 个月发布了 0 个；首次发布于 2013/08/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。