# @cypress/request-promise 中文文档
规范地址：https://npmcn.com/package/%40cypress/request-promise/
版本：5\.0\.0
npm 元数据更新时间：2023-08-24T13:56:07.272Z
中文译文更新时间：2026-11-11T07:19:57.587Z
软件包许可：ISC
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40cypress/request-promise
原文对照：https://npmcn.com/package/%40cypress/request-promise/?lang=original
项目主页：https://github.com/cypress-io/request-promise#readme
源码仓库：https://github.com/cypress-io/request-promise
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：38.3 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=0\.10\.0
- 运行依赖：4 个
- peer 依赖：@cypress/request ^3\.0\.0
- 首次发布：2020-03-18T20:44:07.549Z
- 最新版本发布：2023-08-24T13:56:07.059Z
- 近 30 天下载量：724617（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）
## 中文简介
Cypress的叉子是简化了的HTTP请求客户端的"请求",并附有承诺支持. 由"青鸟"提供动力.
## 安装
```sh
npm install @cypress/request-promise
```
也可以使用：`pnpm add @cypress/request-promise`、`yarn add @cypress/request-promise`、`bun add @cypress/request-promise`
## README
[](http://promisesaplus.com/)
# 请求 - 保证
[](https://gitter.im/request/request-promise?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://travis-ci.org/request/request-promise) [](https://coveralls.io/r/request/request-promise) [](https://david-dm.org/request/request-promise) [](https://snyk.io/test/npm/request-promise)
# 堕落了!
截止2020年2月11日, [`request`](https://github.com/request/request) 完全贬值。 预计不会出现新的变化。 事实上,有一段时间没有人登陆。 此套件还因其依赖于 `request`。 。 。 .
菲伊,这里是 [推理 `request`贬值](https://github.com/request/request/issues/3142) (单位:千美元) [备选图书馆列表](https://github.com/request/request/issues/3143)。 。 。 .
* * *
简化的 HTTP 请求客户端的“ 请求” 支持 。 由"青鸟"提供动力.
[请求](https://github.com/request/request) 财务报告和审定财务报表 [青鸟](https://github.com/petkaantonov/bluebird) 相当棒 但我发现自己采用了同样的设计模式 请求 - 保证增加青鸟动力 `.then(...)` 请求调用对象的方法。 默认情况下,2xx以外的http响应代码会导致承诺被否决. 这可以通过设置来覆盖 `options.simple = false`。 。 。 .
还检查一下新的图书馆 **非常类似 `request-promise` 页:1**数字 :
- [`request-promise-native`](https://github.com/request/request-promise-native) v1 — 不依赖"蓝鸟",而是使用本土ES6承诺.
- [`request-promise-any`](https://github.com/request/request-promise-any) v1 – 允许您注册由 [`any-promise`](https://www.npmjs.com/package/any-promise)。 。 。 .
* * *
## 从v3到v4的迁移
1. `request` 成为同伴依赖。 因此,确保 `request` 以直接依赖方式安装到您的项目中。 ()`npm install --save request`(中文(简体) )
2. 不再支持继续本地存储。 不过,你 [可以获取支持](https://github.com/request/request-promise/wiki/Getting-Back-Support-for-Continuation-Local-Storage) 通过使用 `request-promise-any`。 。 。 .
3. 当你迁移你 `transform` 函数到 v3 并需要添加 `if (!(/^2/.test('' + response.statusCode))) { return resolveWithFullResponse ? response : body; }` 您现在可以设置选项 `transform2xxOnly = true` 换句话说.
## 从v2到v3的迁移
1. 处理 `transform` 函数被大修。 这有两个影响:
- `StatusCodeError.response` 是改变而不是现在的原反应。 当 `options.simple` 实值 `true` (默认). 请更新您的 `transform` 功能还包括非-2xx响应的转换. 要得到旧行为,你可以添加 `if (!(/^2/.test('' + response.statusCode))) { return resolveWithFullResponse ? response : body; }` 转到您的第一行 `transform` 用于请求的函数 `options.simple === true`但是,您可能更喜欢更新您的 `transform` 功能可以转换为2xx 以及非2xxx 响应,因为这使其执行与使用 `simple` 选项.
- 如果变换操作抛出出错误, 请求会以一个 `TransformError`。 。 `cause` 属性包含由变换操作所抛出的错误。 此前,该请求因变换操作所抛出的错误被直接拒绝. 把它包装成一个 `TransformError` 使错误处理更容易.
2. 蓝鸟从v2更新到v3. 这对大多数案件来说都没什么区别 不过,如果您使用高级承诺链,从请求-承诺返回的承诺开始,请检查 [青鸟的新特征和变化](http://bluebirdjs.com/docs/new-in-bluebird-3.html)。 。 。 .
* * *
## 安装
此模块通过 npm 安装 :
```
npm install --save request
npm install --save request-promise
```
`request` 被定义为对等依赖,因此必须单独安装.
## 骗局
```js
var rp = require('request-promise');
```
自兹 `request-promise` 环绕 `request` 所有与工作相关的 `request` 也与 `request-promise`也检查一下 [`request` 文档](https://github.com/request/request) 需要更多的实例.
### 抓取网页
```js
rp('http://www.google.com')
.then(function (htmlString) {
// Process html...
})
.catch(function (err) {
// Crawling failed...
});
```
### 抓取一个更好的网页
```js
var cheerio = require('cheerio'); // Basically jQuery for node.js
var options = {
uri: 'http://www.google.com',
transform: function (body) {
return cheerio.load(body);
}
};
rp(options)
.then(function ($) {
// Process html like you would with jQuery...
})
.catch(function (err) {
// Crawling failed or Cheerio choked...
});
```
### 从JSON里斯特的API那里拿些东西
```js
var options = {
uri: 'https://api.github.com/user/repos',
qs: {
access_token: 'xxxxx xxxxx' // -> uri + '?access_token=xxxxx%20xxxxx'
},
headers: {
'User-Agent': 'Request-Promise'
},
json: true // Automatically parses the JSON string in the response
};
rp(options)
.then(function (repos) {
console.log('User has %d repos', repos.length);
})
.catch(function (err) {
// API call failed...
});
```
### POST 数据为 JSON REST API
设定 `option.body` 您的数据和 `json: true` 把尸体编码成JSON HTML 表格见下文.
```js
var options = {
method: 'POST',
uri: 'http://api.posttestserver.com/post',
body: {
some: 'payload'
},
json: true // Automatically stringifies the body to JSON
};
rp(options)
.then(function (parsedBody) {
// POST succeeded...
})
.catch(function (err) {
// POST failed...
});
```
### POST 像 HTML 窗体做
将数据传递给 `options.form` 以与 HTML 格式相同的方式编码主体:
```js
var options = {
method: 'POST',
uri: 'http://posttestserver.com/post.php',
form: {
// Like
name: 'Josh'
},
headers: {
/* 'content-type': 'application/x-www-form-urlencoded' */ // Is set automatically
}
};
rp(options)
.then(function (body) {
// POST succeeded...
})
.catch(function (err) {
// POST failed...
});
```
如果您想要包含文件上传, 请使用 `options.formData`数字 :
```js
var options = {
method: 'POST',
uri: 'http://posttestserver.com/post.php',
formData: {
// Like
name: 'Jenn',
// Like
file: {
value: fs.createReadStream('test/test.jpg'),
options: {
filename: 'test.jpg',
contentType: 'image/jpg'
}
}
},
headers: {
/* 'content-type': 'multipart/form-data' */ // Is set automatically
}
};
rp(options)
.then(function (body) {
// POST succeeded...
})
.catch(function (err) {
// POST failed...
});
```
### 包含饼干
```js
var tough = require('tough-cookie');
// Easy creation of the cookie - see tough-cookie docs for details
let cookie = new tough.Cookie({
key: "some_key",
value: "some_value",
domain: 'api.mydomain.com',
httpOnly: true,
maxAge: 31536000
});
// Put cookie in an jar which can be used across multiple requests
var cookiejar = rp.jar();
cookiejar.setCookie(cookie, 'https://api.mydomain.com');
// ...all requests to https://api.mydomain.com will include the cookie
var options = {
uri: 'https://api.mydomain.com/...',
jar: cookiejar // Tells rp to include cookies in jar that match uri
};
rp(options)
.then(function (body) {
// Request succeeded...
})
.catch(function (err) {
// Request failed...
});
```
### 得到完整的响应 而不是只是身体
```js
var options = {
method: 'DELETE',
uri: 'http://my-server/path/to/resource/1234',
resolveWithFullResponse: true // <--- <--- <--- <---
};
rp(options)
.then(function (response) {
console.log("DELETE succeeded with status %d", response.statusCode);
})
.catch(function (err) {
// Delete failed...
});
```
### 只有在请求因技术原因失败时才能被拒绝
```js
var options = {
uri: 'http://www.google.com/this-page-does-not-exist.html',
simple: false // <--- <--- <--- <---
};
rp(options)
.then(function (body) {
// Request succeeded but might as well be a 404
// Usually combined with resolveWithFullResponse = true to check response.statusCode
})
.catch(function (err) {
// Request failed due to technical reasons...
});
```
* * *
**更多选项查看 [请求文件](https://github.com/request/request#requestoptions-callback)。 。 。 .**
* * *
## 详细 API
考虑:
- 请求对象
- 与一个 [相同的 API](https://github.com/request/request)数字 : `require('request-promise') == require('request')` 这么说吧
- 不过, **坚持回应** (例如:. `.pipe(...)`)为 **失踪** 因为要求 - 保证会增加 内存足迹 对于大的 要求不必要的高。 使用原始请求库进行此操作 。 您可以在同一项目中使用两个库.
- 在请求调用对象上加上一些方法 :
- `rp(...).then(...)` 或例如:. `rp.post(...).then(...)` 转弯 `rp(...)` 财务报告和审定财务报表 `rp.post(...)` 成为承诺
- `rp(...).catch(...)` 或例如:. `rp.del(...).catch(...)` 和蓝鸟承诺一样
- 错误 `request` 库将传递到回调由 `request-promise` 然后传给捕捉者。 见 [代码示例](https://github.com/request/request-promise#thenonfulfilled-onrejected) 见下文.
- `rp(...).finally(...)` 或例如:. `rp.put(...).finally(...)` 和蓝鸟承诺一样
- `rp(...).cancel()` 或例如:. `rp.get(...).cancel()` 取消请求
- `rp(...).promise()` 或例如:. `rp.head(...).promise()` 返回基础承诺,以便你能够访问全部 [蓝鸟 API](https://github.com/petkaantonov/bluebird/blob/master/API.md)
- 加上一些额外的选项:
- `simple = true` 用于设定 2xx 以外的状态代码是否也应拒绝承诺的布尔
- `resolveWithFullResponse = false` 它是一个布尔来决定 承诺是应该通过充分的反应还是仅仅的反应机构来解决
- `transform` 将响应转换为自定义值,从而实现承诺
- `transform2xxOnly = false` 它是一个布尔来设定变换函数是适用于所有响应,还是仅适用于有 2xx 状态代码的响应
请求返回对象的电话如下: `rp(...)` 或例如:. `rp.post(...)` 是定期承诺/A+遵守承诺,可以被任何兼容的承诺库所同化.
方法 `.then(...)`, (中文(简体) ), `.catch(...)`,以及 `.finally(...)` - 您可以调用请求的调用对象 - 返回一个完整的蓝鸟承诺。 也就是说你满了 [蓝鸟 API](https://github.com/petkaantonov/bluebird/blob/master/API.md) 可供进一步连锁使用。 例如: `rp(...).then(...).spread(...)` 但是,如果您需要一种方法,而不是 `.then(...)`, (中文(简体) ), `.catch(...)`,或 `.finally(...)` 将会是 **首个** 在链中,使用 `.promise()`数字 : `rp(...).promise().bind(...).then(...)`
### .当时(已填入,已拒绝)
```js
// As a Request user you would write:
var request = require('request');
request('http://google.com', function (err, response, body) {
if (err) {
handleError({ error: err, response: response, ... });
} else if (!(/^2/.test('' + response.statusCode))) { // Status Codes other than 2xx
handleError({ error: body, response: response, ... });
} else {
process(body);
}
});
// As a Request-Promise user you can now write the equivalent code:
var rp = require('request-promise');
rp('http://google.com')
.then(process, handleError);
```
```js
// The same is available for all http method shortcuts:
request.post('http://example.com/api', function (err, response, body) { ... });
rp.post('http://example.com/api').then(...);
```
### . 渔获物(被拒)
```js
rp('http://google.com')
.catch(handleError);
// ... is syntactical sugar for:
rp('http://google.com')
.then(null, handleError);
// However, this:
rp('http://google.com')
.then(process)
.catch(handleError);
// ... is safer than:
rp('http://google.com')
.then(process, handleError);
```
关于更多信息 `.then(process).catch(handleError)` 对 `.then(process, handleError)`,参见蓝鸟文件 [承诺反攻击](http://bluebirdjs.com/docs/anti-patterns.html#the-.then)。 。 。 .
### . 最终(完成)
```js
rp('http://google.com')
.finally(function () {
// This is called after the request finishes either successful or not successful.
});
```
### .cancel () (中文(简体) )
使用此方法取消请求 [蓝鸟的取消功能](http://bluebirdjs.com/docs/api/cancellation.html)。 。 。 .
何时 `.cancel()` 称为:
- 约言既不解,也不解脱
- 请求是 [已中止](https://nodejs.org/dist/latest-v6.x/docs/api/http.html#http_request_abort)。 。 。 .
### .承诺() - 用于高级用途
为了不污染 请求调用对象 与基础 蓝鸟承诺的方法 `.then(...)`, (中文(简体) ), `.catch(...)`,以及 `.finally(...)` 暴露在大多数使用案例。 效果是蓝鸟承诺的任何方法 `.then(...)`, (中文(简体) ), `.catch(...)`,或 `.finally(...)` 无法用作 **首个** 承诺链中的方法:
```js
// This works:
rp('http://google.com').then(function () { ... });
rp('http://google.com').catch(function () { ... });
// This works as well since additional methods are only used AFTER the FIRST call in the chain:
rp('http://google.com').then(function () { ... }).spread(function () { ... });
rp('http://google.com').catch(function () { ... }).error(function () { ... });
// Using additional methods as the FIRST call in the chain does not work:
// rp('http://google.com').bind(this).then(function () { ... });
// Use .promise() in these cases:
rp('http://google.com').promise().bind(this).then(function () { ... });
```
### 履行诺言 `resolveWithFullResponse` 选项
```js
// Per default the body is passed to the fulfillment handler:
rp('http://google.com')
.then(function (body) {
// Process the html of the Google web page...
});
// The resolveWithFullResponse options allows to pass the full response:
rp({ uri: 'http://google.com', resolveWithFullResponse: true })
.then(function (response) {
// Access response.statusCode, response.body etc.
});
```
### 拒绝承诺 `simple` 选项
```js
// The rejection handler is called with a reason object...
rp('http://google.com')
.catch(function (reason) {
// Handle failed request...
});
// ... and would be equivalent to this Request-only implementation:
var options = { uri: 'http://google.com' };
request(options, function (err, response, body) {
var reason;
if (err) {
reason = {
cause: err,
error: err,
options: options,
response: response
};
} else if (!(/^2/.test('' + response.statusCode))) { // Status Codes other than 2xx
reason = {
statusCode: response.statusCode,
error: body,
options: options,
response: response
};
}
if (reason) {
// Handle failed request...
}
});
// If you pass the simple option as false...
rp({ uri: 'http://google.com', simple: false })
.catch(function (reason) {
// Handle failed request...
});
// ... the equivalent Request-only code would be:
request(options, function (err, response, body) {
if (err) {
var reason = {
cause: err,
error: err,
options: options,
response: response
};
// Handle failed request...
}
});
// E.g. a 404 would now fulfill the promise.
// Combine it with resolveWithFullResponse = true to check the status code in the fulfillment handler.
```
有了0.4版本后,原因对象变成了具有相同属性的 Error对象,以确保后向相容性. 这些新的错误类型允许目标捕获区块:
```js
var errors = require('request-promise/errors');
rp('http://google.com')
.catch(errors.StatusCodeError, function (reason) {
// The server responded with a status codes other than 2xx.
// Check reason.statusCode
})
.catch(errors.RequestError, function (reason) {
// The request failed due to technical reasons.
// reason.cause is the Error object Request would pass into a callback.
});
```
### 这个 `transform` 函数
您可以将函数传递给 `options.transform` 以生成一个自定义的实现值当承诺得到解决时.
```js
// Just for fun you could reverse the response body:
var options = {
uri: 'http://google.com',
transform: function (body, response, resolveWithFullResponse) {
return body.split('').reverse().join('');
}
};
rp(options)
.then(function (reversedBody) {
// ;D
});
// However, you could also do something useful:
var $ = require('cheerio'); // Basically jQuery for node.js
function autoParse(body, response, resolveWithFullResponse) {
// FIXME: The content type string could contain additional values like the charset.
// Consider using the `content-type` library for a robust comparison.
if (response.headers['content-type'] === 'application/json') {
return JSON.parse(body);
} else if (response.headers['content-type'] === 'text/html') {
return $.load(body);
} else {
return body;
}
}
options.transform = autoParse;
rp(options)
.then(function (autoParsedBody) {
// :)
});
// You can go one step further and set the transform as the default:
var rpap = rp.defaults({ transform: autoParse });
rpap('http://google.com')
.then(function (autoParsedBody) {
// :)
});
rpap('http://echojs.com')
.then(function (autoParsedBody) {
// =)
});
```
第三个 `resolveWithFullResponse` 变换函数的参数相当于随请求而通过的选项. 这使得可以区分是否只有被转化的正体或整个响应才能被转换函数还原:
```js
function reverseBody(body, response, resolveWithFullResponse) {
response.body = response.body.split('').reverse().join('');
return resolveWithFullResponse ? response : response.body;
}
```
至于Request-Promise v3,变换功能是ALWAYS针对非-2xx响应执行的. 何时 `options.simple` 设置为 `true` (违约)然后以 `StatusCodeError`。在此情况下,错误包含变换的响应 :
```js
var options = {
uri: 'http://the-server.com/will-return/404',
simple: true,
transform: function (body, response, resolveWithFullResponse) { /* ... */ }
};
rp(options)
.catch(errors.StatusCodeError, function (reason) {
// reason.response is the transformed response
});
```
准备 `options.transform2xxOnly = true` 只执行带有2xx状态代码的响应的变换功能。 对于其他状态代码——独立于任何其他设置,例如. `options.simple` – 变换功能没有执行.
#### 处理错误
如果变换操作失败( 显示出错 ) , 请求将被以 a 拒绝 `TransformError`数字 :
```js
var errors = require('request-promise/errors');
var options = {
uri: 'http://google.com',
transform: function (body, response, resolveWithFullResponse) {
throw new Error('Transform failed!');
}
};
rp(options)
.catch(errors.TransformError, function (reason) {
console.log(reason.cause.message); // => Transform failed!
// reason.response is the original response for which the transform operation failed
});
```
## 对继续当地储存的实验支助
不再支持继续本地存储。 不过,你 [可以获取支持](https://github.com/request/request-promise/wiki/Getting-Back-Support-for-Continuation-Local-Storage) 通过使用 `request-promise-any`。 。 。 .
## 调试
调试“ 请求保证” 操作的方法是一样的 [说明](https://github.com/request/request#debugging) 请求。 它们是:
1. 启动节点进程像 `NODE_DEBUG=request node script.js` (单位:千美元)`lib,request,otherlib` 工作也一样.
2. 设定 `require('request-promise').debug = true` 任何时候(这与#1相同).
3. 使用 [请求调试模块](https://github.com/nylen/request-debug) 以查看请求和答复标题及机构。 文书要求-承诺 `require('request-debug')(rp);`。 。 。 .
## 模拟请求 - 保证
通常您想要模拟整个请求函数,该函数由 `require('request-promise')`。这不可能通过使用像 [sinon.js (英语)](http://sinonjs.org/) 一个人 你需要的是一个库,它连接到模块加载器,并确保在测试代码调用时返回您的模拟器 `require('request-promise')`。 。 。 . [摩克语Name](https://github.com/mfncooper/mockery) 是这种图书馆之一.
@florianschmidt 1994 (法语). 他的解决方案是:
```javascript
before(function (done) {
var filename = "fileForResponse";
mockery.enable({
warnOnReplace: false,
warnOnUnregistered: false,
useCleanCache: true
});
mockery.registerMock('request-promise', function () {
var response = fs.readFileSync(__dirname + '/data/' + filename, 'utf8');
return Bluebird.resolve(response.trim());
});
done();
});
after(function (done) {
mockery.disable();
mockery.deregisterAll();
done();
});
describe('custom test case', function () {
// Test some function/module/... which uses request-promise
// and it will always receive the predefined "fileForResponse" as data, e.g.:
var rp = require('request-promise');
rp(...).then(function(data) {
// ➞ data is what is in fileForResponse
});
});
```
以此为基础,你现在可以建立一个更复杂的模型. [锡农.js](http://sinonjs.org/) 也可能有帮助.
## 捐款
为建立你的发展环境:
1. 复制重播到您的桌面,
2. 在壳中 `cd` 到主文件夹,
3. 击出 `npm install`, (中文(简体) ),
4. 击出 `npm install gulp -g` 如果你还没有在全球安装gulp,和
5. 运行 `gulp dev`. (或运行) `node ./node_modules/.bin/gulp dev` 如果你不想在全球安装gulp。)
`gulp dev` 监视所有源文件, 如果您保存一些更改, 它会插入代码并执行所有测试 。 测试覆盖报告可从下列来源查看: `./coverage/lcov-report/index.html`。 。 。 .
如果您想要调试测试, 请使用 `gulp test-without-coverage` 运行所有测试,而不通过测试覆盖仪表来模糊代码.
## 更改历史
- v4.2.5 (2019-11-03) (中文(简体) )
- 安全固定:被撞倒 `request-promise-core` 缓冲 `lodash` 改为 `^4.17.15`。见 [脆弱性报告](https://snyk.io/vuln/search?q=lodash&type=npm)。 。 。 . _(感谢@rishabh-chowdhary在拉动请求中报告此事) [#326号](https://github.com/request/request-promise/pull/326). ) (中文(简体) )_
- v 4.2.4 (2019-02-14) (中文(简体) )
- 错误设定 `tough-cookie` 版本,现在 `^2.3.3` _(多亏了@eforceur指出这一点_
- 如果安装 `request-promise@4.2.3` 请在升级后确保 `request` 财务报告和审定财务报表 `request-promise` 使用相同的物理副本 `tough-cookie`。 。 。 .
- v 4.2.3 (2019-02-14) (中文(简体) )
- 使用更严格的 `tough-cookie@~2.3.3` 避免安装 `tough-cookie@3` 引入断开更改 _(感谢@aomdoa的拉动请求) [299号](https://github.com/request/request-promise/pull/299)(中文(简体) )_
- 安全固定:被撞倒 `lodash` 改为 `^4.17.11`,参见 [脆弱性报告](https://snyk.io/vuln/search?q=lodash&type=npm)
- v4.2.2 (2017-09-22) (中文(简体) )
- 升级 `tough-cookie` 到一个没有regex DoS 弱点的版本 _(感谢@rouanw [拉动请求 # 226](https://github.com/request/request-promise/pull/226)(中文(简体) )_
- v4.2.1 (2017-05-07) (中文(简体) )
- 允许使用的修复 `tough-cookie` 用于饼干创建 _(感谢@ScottyMJacobson的报告) [问题183](https://github.com/request/request-promise/issues/183)(中文(简体) )_
- 已添加 [饼干处理示例](https://github.com/request/request-promise#include-a-cookie) 到骗局 _(感谢@chovy和@教授Tom) [问它](https://github.com/request/request-promise/issues/79)(中文(简体) )_
- v4.2.0 (2017-03-16) (中文(简体) )
- 更新 `bluebird` 改为 v3.5 _(感谢@acinader [拉动请求 # 181](https://github.com/request/request-promise/pull/181)(中文(简体) )_
- v 4.1.1 (2016-08-08) (中文(简体) )
- 重新命名内部使用的软件包 `@request/promise-core` 改为 `request-promise-core` 因为那里 [还有](https://github.com/request/request-promise/issues/137) [数量](https://github.com/request/request-promise/issues/141) 带有范围软件包名称的问题 _(感谢@cabrinoob,@crazy4groovy,@dsandor,@KpjComp,@lorenwest,@Reisyukaku,@teh Chromic,@todd 提供有用信息。 )_
- v4.1.0 (2016-07-30) (中文(简体) )
- 已添加取消支持 _(感谢@not-an-aardvark为 [拉动请求 # 123](https://github.com/request/request-promise/pull/123)(中文(简体) )_
- v4.02 (2016-07-18) (中文(简体) )
- 用于 Webpack 和浏览器等模块捆绑器的修复
- v4.0.1 (2016-07-17) (中文(简体) )
- 固定 `@request/promise-core` 用于更安全版本的版本
- v4.0.0 (2016-07-15) (中文(简体) )
- **中断更改**数字 : `request` 被宣布为对等依赖, 用户现在必须单独安装
- **中断更改**: 自此停止对继续本地存储的支持 [`request-promise-any`](https://github.com/request/request-promise-any) 可能会是 [使用过的](https://github.com/request/request-promise/wiki/Getting-Back-Support-for-Continuation-Local-Storage) 现在
- 介绍 `transform2xxOnly` 选项,以缓解关于新的 `transform` 在v3.0.0中处理 _(感谢@stevage指出 [问题131](https://github.com/request/request-promise/issues/131)(中文(简体) )_
- 已解决的问题 [65号](https://github.com/request/request-promise/issues/65) 财务报告和审定财务报表 [71号](https://github.com/request/request-promise/issues/71) 通过出版几乎完全相同的图书馆来支持其他承诺的执行: [`request-promise-native`](https://github.com/request/request-promise-native) 财务报告和审定财务报表 [`request-promise-any`](https://github.com/request/request-promise-any) _(感谢@benjamingr,@eilgin,@gillesdemey,@hildjj,@iggycoloma,@jonathanong,@knpwrs,@MarkHerhold,@massimocode,@mikeal,@niftylettuce,@raitucarp,@sher deadlock,@tonylukasavage,和@vgoloviznin的宝贵讨论!)_
- 持ISC牌照的图书馆
- v3.0.0 (2016-04-16) (中文(中国大陆) )
- **中断更改**: 更改处理 `transform` 函数 _(感谢@Limes解释需要在 [问题86](https://github.com/request/request-promise/issues/86)(中文(简体) )_
- **中断更改**翻译: `bluebird` 改为v3 _(感谢您@ BrandonSmith [拉动请求 # 103](https://github.com/request/request-promise/pull/103)(中文(简体) )_
- 改进 `StatusCodeError.message`
- 更新 `lodash` 改为v4.6
- 改进了在教育、教育、教育、 `.catch(...)` 最佳做法 _(感谢@ RebootJeff [拉动请求 # 98](https://github.com/request/request-promise/pull/98)(中文(简体) )_
- v2.0.1 (2016-02-17) (中文(简体) )
- 更新 `lodash` 改为v4 _(感谢 @ ratson for [拉动请求 # 94](https://github.com/request/request-promise/pull/94)(中文(简体) )_
- v2.0.0 (2016-01-12) (中文(简体) )
- **中断更改**: 已删除 `cls-bluebird` 用户现在必须安装的依赖性 _(感谢@hildjj) [拉动请求 # 75](https://github.com/request/request-promise/pull/75)(中文(简体) )_
- `npm shrinkwrap` 现在为 `npm@3` 不使用的用户 `continuation-local-storage` _(感谢@toboid和@rstacruz在2008年9月20日上报) [问题70](https://github.com/request/request-promise/issues/70) 财务报告和审定财务报表 [82号问题](https://github.com/request/request-promise/issues/82)(中文(简体) )_
- v1.0.2 (2015-10-22) (中文(简体) )
- 删除 `continuation-local-storage` 从同行的依赖性,因为它是不必要的 _(感谢@mrhyde 努力寻求更好的解决办法,讨论 [问题70](https://github.com/request/request-promise/issues/70)(中文(简体) )_
- v1.0.1(2015-10-14) (中文(简体) )
- 通过标记固定 npm 警告 `continuation-local-storage` 作为同伴依赖
- v1.0.0 (2015-10-11) (中文(简体) )
- **中断更改**: 先前同步抛出的一些错误, 如输入参数错误, 现在被传递给被拒绝的许诺 _(感谢@josnidhin建议 [问题43](https://github.com/request/request-promise/issues/43)(中文(简体) )_
- **中断更改**: Request-Promise不再装入自己的"青鸟"原型. 如果你在项目中使用了"蓝鸟"并修改了原型,那么"请求-保证"可能会在内部使用被修改了的"蓝鸟"原型.
- 对于头部请求,将返回标题而不是空正文(除非 `resolveWithFullResponse = true` 用于) _(感谢@zcei提议更改 [问题58](https://github.com/request/request-promise/issues/58)(中文(简体) )_
- 扩展 `transform` 函数 : `resolveWithFullResponse` 参数
- 为继续本地存储增加实验支持 _(感谢@ silverbp 准备此文件) [问题64](https://github.com/request/request-promise/issues/64)(中文(简体) )_
- 将节点.js 4 添加到 Travis CI 大楼
- 更新了读取器 _(感谢许多人对问题的反馈) [55号](https://github.com/request/request-promise/issues/55) 财务报告和审定财务报表 [59号](https://github.com/request/request-promise/issues/59)(中文(简体) )_
- v.4.3 (2015-07-27) (中文(简体) )
- 减少间接费用,只是需要用到的摇篮功能,而不是整个摇篮库 _(感谢@luanmuniz [牵引请求 # 54](https://github.com/request/request-promise/pull/54)(中文(简体) )_
- 更新的依赖关系
- v.4.2 (2015-04-12) (中文(简体) )
- 更新的依赖关系
- v. 4.1 (2015-03-20) (中文(简体) )
- 在没有 v8 引擎的浏览器中工作的改进错误类型 _(感谢@nodiis [拉动请求 # 40](https://github.com/request/request-promise/pull/40)(中文(简体) )_
- v. 4.0 (2015-02-08) (中文(简体) )
- 用于拒绝理由的错误类型(见最后一部分) [本节](https://npmcn.com/package/%40cypress/request-promise/#readme-rejected-promises-and-the-simple-option)(中文(简体) ) _(感谢@jakecraige在2008年启动讨论) [问题38](https://github.com/request/request-promise/issues/38)(中文(简体) )_
- **小中断更改 :** 拒绝原因对象成为实际错误对象 。 不过, `typeof reason === 'object'` 仍然保持真实性,错误对象具有与前一个原因对象相同的属性. 如果拒绝处理器只访问原因对象上的属性(通常是这种情况),则不需要迁移.
- 将io.js和节点.js 0.12加到Travis CI大楼
- v. 3.3 (2015-01-19) (中文(简体) )
- 固定处理可能未处理的拒绝 以配合最新版本的"蓝鸟" _(感谢@slang800将此事报告给 [问题36](https://github.com/request/request-promise/issues/36)(中文(简体) )_
- v.3.2 (2014-11-17) (中文(简体) )
- 已曝光 `.finally(...)` 允许将它作为承诺链中的第一个方法 _(感谢@hjpbarcelos的帮助) [拉动请求 # 28](https://github.com/request/request-promise/pull/28)(中文(简体) )_
- v. 3.1 (2014-11-11) (中文(简体) )
- 添加内容 `.promise()` 高级蓝鸟 API 使用方法 _(感谢@devo-tox的反馈) [问题27](https://github.com/request/request-promise/issues/27)(中文(简体) )_
- v. 3.0 (2014-11-10) (中文(简体) )
- 谨慎地从零开始重写, 使 Request- 保证为 Request 替换一个 滴入
## 许可证(ISC)
以防你从没听说过 [ISC 许可证](http://en.wikipedia.org/wiki/ISC_license) 它在功能上相当于麻省理工学院的许可.
见 [自由文件](https://npmcn.com/package/%40cypress/request-promise/LICENSE) 详细情况.
## 常见问题
### @cypress/request-promise 是什么？
Cypress的叉子是简化了的HTTP请求客户端的"请求",并附有承诺支持\. 由"青鸟"提供动力\.
### 如何安装 @cypress/request-promise？
在项目目录运行 npm install @cypress/request-promise，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@cypress/request（^3\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @cypress/request-promise 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cypress\_\_request-promise 是否存在。
### @cypress/request-promise 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。
### @cypress/request-promise 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=0\.10\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @cypress/request-promise 可以商用吗？
@cypress/request-promise 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @cypress/request-promise 的下载量有多少？
根据 npm 官方下载统计，@cypress/request-promise 在 2026/10/11 – 2026/11/09 这 30 天内被下载 724,617 次，日均约 24,154 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @cypress/request-promise 还在维护吗？
最新版本 5\.0\.0 发布于 2023/08/24（3 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/03/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。