跳转至

Request

让我们以Request's readme中的第一个例子为例:

1
2
3
4
5
6
7
import request from "request";

request("https://google.com", (error, response, body) => {
  console.log("error:", error);
  console.log("statusCode:", response && response.statusCode);
  console.log("body:", body);
});

对于 Got，它是:

1
2
3
4
5
6
7
8
9
import got from "got";

try {
  const response = await got("https://google.com");
  console.log("statusCode:", response.statusCode);
  console.log("body:", response.body);
} catch (error) {
  console.log("error:", error);
}

现在看起来好多了，是吧? 😎

常见的选项

这些 Got 选项与 Request 相同:

time 选项不存在，假设它总是正确.

如果你熟悉这些，就可以开始了。

重命名选项

Note

得到存储HTTPS选项在httpoptions。其中一些已经被重新命名。 了解更多.

可读性对我们来说非常重要，所以我们对这些选项有不同的名称:

行为变化

  • The agent option is now an object with http, https and http2 properties.
  • The timeout option is now an object. You can set timeouts on particular events!
  • The searchParams option is always serialized using URLSearchParams.
  • In order to pass a custom query string, provide it with the url option.
    got('https://example.com', {searchParams: {test: ''}}) → https://example.com/?test=
    got('https://example.com/?test') → https://example.com/?test
  • To use streams, call got.stream(url, options) or got(url, {…, isStream: true}).

突发的变化

  • The json option is not a boolean, it's an object. It will be stringified and used as a body.
  • The form option is an object and will be used as application/x-www-form-urlencoded body.
  • All headers are converted to lowercase.
    According to the spec, the headers are case-insensitive.
  • No oauth / hawk / aws / httpSignature option.
    To sign requests, you need to create a custom instance.
  • No agentClass / agentOptions / pool option.
  • No forever option.
    You need to pass an agent with keepAlive option set to true.
  • No proxy option. You need to pass a custom agent.
  • No auth option.
    You need to use username / password instead or set the authorization header manually.
  • No baseUrl option.
    Instead, there is prefixUrl which appends a trailing slash if not present.
  • No removeRefererHeader option.
    You can remove the referer header in a beforeRequest hook.
  • No followAllRedirects option.

Hooks are very powerful. Read more to see what else you achieve using hooks.

关于流的更多信息

让我们快速看一下 Request 自述中的另一个例子:

1
2
3
4
5
6
7
http.createServer((serverRequest, serverResponse) => {
  if (serverRequest.url === "/doodle.png") {
    serverRequest
      .pipe(request("https://example.com/doodle.png"))
      .pipe(serverResponse);
  }
});

这里很酷的特性是 Request 可以用流代理报头，但 Got 也可以这样做!

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
import { promisify } from "node:util";
import stream from "node:stream";
import got from "got";

const pipeline = promisify(stream.pipeline);

const server = http.createServer(async (serverRequest, serverResponse) => {
  if (serverRequest.url === "/doodle.png") {
    await pipeline(
      got.stream("https://example.com/doodle.png"),
      serverResponse
    );
  }
});

server.listen(8080);

就流而言，什么都没有真正改变。

方便的方法

  • If you were using request.get, request.post, and so on - you can do the same with Got.
  • The request.defaults({…}) method has been renamed. You can do the same with got.extend({…}).
  • There is no request.cookie() nor request.jar(). You have to use tough-cookie directly.

你可以开始了!

好吧，你已经走了这么远🎉 看一下文档。值得花时间读一读。 这里有一些很棒的建议。

如果某件事不清楚或没有按照它应该的方式运行，不要犹豫打开一个问题.