@depup/got 14.6.6-depup.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +36 -0
  2. package/changes.json +30 -0
  3. package/dist/source/as-promise/index.d.ts +3 -0
  4. package/dist/source/as-promise/index.js +204 -0
  5. package/dist/source/as-promise/types.d.ts +37 -0
  6. package/dist/source/as-promise/types.js +17 -0
  7. package/dist/source/core/calculate-retry-delay.d.ts +4 -0
  8. package/dist/source/core/calculate-retry-delay.js +29 -0
  9. package/dist/source/core/diagnostics-channel.d.ts +89 -0
  10. package/dist/source/core/diagnostics-channel.js +49 -0
  11. package/dist/source/core/errors.d.ts +102 -0
  12. package/dist/source/core/errors.js +147 -0
  13. package/dist/source/core/index.d.ts +192 -0
  14. package/dist/source/core/index.js +1339 -0
  15. package/dist/source/core/options.d.ts +1564 -0
  16. package/dist/source/core/options.js +1838 -0
  17. package/dist/source/core/parse-link-header.d.ts +4 -0
  18. package/dist/source/core/parse-link-header.js +33 -0
  19. package/dist/source/core/response.d.ts +109 -0
  20. package/dist/source/core/response.js +41 -0
  21. package/dist/source/core/timed-out.d.ts +31 -0
  22. package/dist/source/core/timed-out.js +136 -0
  23. package/dist/source/core/utils/defer-to-connect.d.ts +9 -0
  24. package/dist/source/core/utils/defer-to-connect.js +44 -0
  25. package/dist/source/core/utils/get-body-size.d.ts +2 -0
  26. package/dist/source/core/utils/get-body-size.js +37 -0
  27. package/dist/source/core/utils/is-client-request.d.ts +4 -0
  28. package/dist/source/core/utils/is-client-request.js +4 -0
  29. package/dist/source/core/utils/is-form-data.d.ts +7 -0
  30. package/dist/source/core/utils/is-form-data.js +4 -0
  31. package/dist/source/core/utils/is-unix-socket-url.d.ts +17 -0
  32. package/dist/source/core/utils/is-unix-socket-url.js +25 -0
  33. package/dist/source/core/utils/options-to-url.d.ts +12 -0
  34. package/dist/source/core/utils/options-to-url.js +48 -0
  35. package/dist/source/core/utils/proxy-events.d.ts +2 -0
  36. package/dist/source/core/utils/proxy-events.js +15 -0
  37. package/dist/source/core/utils/timer.d.ts +31 -0
  38. package/dist/source/core/utils/timer.js +162 -0
  39. package/dist/source/core/utils/unhandle.d.ts +10 -0
  40. package/dist/source/core/utils/unhandle.js +20 -0
  41. package/dist/source/core/utils/url-to-options.d.ts +14 -0
  42. package/dist/source/core/utils/url-to-options.js +22 -0
  43. package/dist/source/core/utils/weakable-map.d.ts +7 -0
  44. package/dist/source/core/utils/weakable-map.js +24 -0
  45. package/dist/source/create.d.ts +3 -0
  46. package/dist/source/create.js +188 -0
  47. package/dist/source/index.d.ts +16 -0
  48. package/dist/source/index.js +22 -0
  49. package/dist/source/types.d.ts +314 -0
  50. package/dist/source/types.js +1 -0
  51. package/license +9 -0
  52. package/package.json +197 -0
  53. package/readme.md +478 -0
package/readme.md ADDED
@@ -0,0 +1,478 @@
1
+ <div align="center">
2
+ <br>
3
+ <br>
4
+ <img width="360" src="media/logo.svg" alt="Got">
5
+ <br>
6
+ <br>
7
+ <br>
8
+ <br>
9
+ <hr>
10
+ <p>
11
+ <p>
12
+ <sup>
13
+ Sindre's open source work is supported by the community.<br>Special thanks to:
14
+ </sup>
15
+ </p>
16
+ <br>
17
+ <br>
18
+ <a href="https://www.fame.fi#gh-light-mode-only">
19
+ <img src="https://sindresorhus.com/assets/thanks/fame-logo-light.svg" width="200" alt="Fame Helsinki">
20
+ </a>
21
+ <a href="https://www.fame.fi#gh-dark-mode-only">
22
+ <img src="https://sindresorhus.com/assets/thanks/fame-logo-dark.svg" width="200" alt="Fame Helsinki">
23
+ </a>
24
+ <br>
25
+ <br>
26
+ <br>
27
+ <br>
28
+ <a href="https://depot.dev?utm_source=github&utm_medium=sindresorhus">
29
+ <div>
30
+ <picture>
31
+ <source width="180" media="(prefers-color-scheme: dark)" srcset="https://sindresorhus.com/assets/thanks/depot-logo-dark.svg">
32
+ <source width="180" media="(prefers-color-scheme: light)" srcset="https://sindresorhus.com/assets/thanks/depot-logo-light.svg">
33
+ <img width="180" src="https://sindresorhus.com/assets/thanks/depot-logo-light.svg" alt="Depot logo">
34
+ </picture>
35
+ </div>
36
+ <b>Fast remote container builds and GitHub Actions runners.</b>
37
+ </a>
38
+ <br>
39
+ <br>
40
+ <br>
41
+ </p>
42
+ <hr>
43
+ <br>
44
+ <br>
45
+ <br>
46
+ <br>
47
+ <br>
48
+ <br>
49
+ <br>
50
+ </div>
51
+
52
+ > Human-friendly and powerful HTTP request library for Node.js
53
+
54
+ <!-- [![Coverage Status](https://codecov.io/gh/sindresorhus/got/branch/main/graph/badge.svg)](https://codecov.io/gh/sindresorhus/got/branch/main) -->
55
+ [![Downloads](https://img.shields.io/npm/dm/got.svg)](https://npmjs.com/got)
56
+ [![Install size](https://packagephobia.com/badge?p=got)](https://packagephobia.com/result?p=got)
57
+
58
+ [See how Got compares to other HTTP libraries](#comparison)
59
+
60
+ ---
61
+
62
+ **You probably want [Ky](https://github.com/sindresorhus/ky) instead, by the same people. It's smaller, works in the browser too, and is more stable since it's built on [`Fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API). Or [fetch-extras](https://github.com/sindresorhus/fetch-extras) for simple needs.**
63
+
64
+ ---
65
+
66
+ **Support questions should be asked [here](https://github.com/sindresorhus/got/discussions).**
67
+
68
+ ## Install
69
+
70
+ ```sh
71
+ npm install got
72
+ ```
73
+
74
+ **Warning:** This package is native [ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) and no longer provides a CommonJS export. If your project uses CommonJS, you will have to [convert to ESM](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c). Please don't open issues for questions regarding CommonJS / ESM.
75
+
76
+ **Got v11 is no longer maintained and we will not accept any backport requests.**
77
+
78
+ ## Take a peek
79
+
80
+ **A [quick start](documentation/quick-start.md) guide is available.**
81
+
82
+ ### JSON mode
83
+
84
+ Got has a dedicated option for handling JSON payload.\
85
+ Furthermore, the promise exposes a `.json<T>()` function that returns `Promise<T>`.
86
+
87
+ ```js
88
+ import got from 'got';
89
+
90
+ const {data} = await got.post('https://httpbin.org/anything', {
91
+ json: {
92
+ hello: 'world'
93
+ }
94
+ }).json();
95
+
96
+ console.log(data);
97
+ //=> {"hello": "world"}
98
+ ```
99
+
100
+ For advanced JSON usage, check out the [`parseJson`](documentation/2-options.md#parsejson) and [`stringifyJson`](documentation/2-options.md#stringifyjson) options.
101
+
102
+ **For more useful tips like this, visit the [Tips](documentation/tips.md) page.**
103
+
104
+ ## Highlights
105
+
106
+ - [Used by 10K+ packages and 5M+ repos](https://github.com/sindresorhus/got/network/dependents)
107
+ - [Actively maintained](https://github.com/sindresorhus/got/graphs/contributors)
108
+ - [Trusted by many companies](#widely-used)
109
+
110
+ ## Documentation
111
+
112
+ By default, Got will retry on failure. To disable this option, set [`options.retry.limit`](documentation/7-retry.md#retry) to 0.
113
+
114
+ #### Main API
115
+
116
+ - [x] [Promise API](documentation/1-promise.md)
117
+ - [x] [Options](documentation/2-options.md)
118
+ - [x] [Stream API](documentation/3-streams.md)
119
+ - [x] [Pagination API](documentation/4-pagination.md)
120
+ - [x] [Advanced HTTPS API](documentation/5-https.md)
121
+ - [x] [HTTP/2 support](documentation/2-options.md#http2)
122
+ - [x] [`Response` class](documentation/3-streams.md#response-2)
123
+
124
+ #### Timeouts and retries
125
+
126
+ - [x] [Advanced timeout handling](documentation/6-timeout.md)
127
+ - [x] [Retries on failure](documentation/7-retry.md)
128
+ - [x] [Errors with metadata](documentation/8-errors.md)
129
+
130
+ #### Advanced creation
131
+
132
+ - [x] [Hooks](documentation/9-hooks.md)
133
+ - [x] [Instances](documentation/10-instances.md)
134
+ - [x] [Progress events & other events](documentation/3-streams.md#events)
135
+ - [x] [Plugins](documentation/lets-make-a-plugin.md)
136
+ - [x] [Compose](documentation/examples/advanced-creation.js)
137
+
138
+ #### Cache, Proxy and UNIX sockets
139
+
140
+ - [x] [RFC compliant caching](documentation/cache.md)
141
+ - [x] [Proxy support](documentation/tips.md#proxying)
142
+ - [x] [Unix Domain Sockets](documentation/2-options.md#enableunixsockets)
143
+
144
+ #### Integration
145
+
146
+ - [x] [Diagnostics Channel](documentation/diagnostics-channel.md)
147
+ - [x] [TypeScript support](documentation/typescript.md)
148
+ - [x] [AWS](documentation/tips.md#aws)
149
+ - [x] [Testing](documentation/tips.md#testing)
150
+
151
+ ---
152
+
153
+ ### Migration guides
154
+
155
+ - [Request migration guide](documentation/migration-guides/request.md)
156
+ - [*(Note that Request is unmaintained)*](https://github.com/request/request/issues/3142)
157
+ - [Axios](documentation/migration-guides/axios.md)
158
+ - [Node.js](documentation/migration-guides/nodejs.md)
159
+
160
+ ## Got plugins
161
+
162
+ - [`got4aws`](https://github.com/SamVerschueren/got4aws) - Got convenience wrapper to interact with AWS v4 signed APIs
163
+ - [`gh-got`](https://github.com/sindresorhus/gh-got) - Got convenience wrapper to interact with the GitHub API
164
+ - [`gl-got`](https://github.com/singapore/gl-got) - Got convenience wrapper to interact with the GitLab API
165
+ - [`gotql`](https://github.com/khaosdoctor/gotql) - Got convenience wrapper to interact with GraphQL using JSON-parsed queries instead of strings
166
+ - [`got-fetch`](https://github.com/alexghr/got-fetch) - Got with a [`fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) interface
167
+ - [`got-scraping`](https://github.com/apify/got-scraping) - Got wrapper specifically designed for web scraping purposes
168
+ - [`got-ssrf`](https://github.com/JaneJeon/got-ssrf) - Got wrapper to protect server-side requests against SSRF attacks
169
+
170
+ ## Comparison
171
+
172
+ | | `got` | [`node-fetch`][n0] | [`ky`][k0] | [`axios`][a0] | [`superagent`][s0] |
173
+ |-----------------------|:-------------------:|:--------------------:|:------------------------:|:------------------:|:----------------------:|
174
+ | HTTP/2 support | :heavy_check_mark:¹ | :x: | :heavy_check_mark: | :x: | :heavy_check_mark:\*\* |
175
+ | Browser support | :x: | :heavy_check_mark:\* | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
176
+ | Promise API | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
177
+ | Stream API | :heavy_check_mark: | Node.js only | :x: | :x: | :heavy_check_mark: |
178
+ | Pagination API | :heavy_check_mark: | :x: | :x: | :x: | :x: |
179
+ | Request cancelation | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
180
+ | RFC compliant caching | :heavy_check_mark: | :x: | :x: | :x: | :x: |
181
+ | Cookies (out-of-the-box) | :heavy_check_mark: | :x: | :x: | :x: | :x: |
182
+ | Follows redirects | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
183
+ | Retries on failure | :heavy_check_mark: | :x: | :heavy_check_mark: | :x: | :heavy_check_mark: |
184
+ | Progress events | :heavy_check_mark: | :x: | :heavy_check_mark: | Browser only | :heavy_check_mark: |
185
+ | Handles gzip/deflate | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
186
+ | Advanced timeouts | :heavy_check_mark: | :x: | :x: | :x: | :x: |
187
+ | Timings | :heavy_check_mark: | :x: | :x: | :x: | :x: |
188
+ | Errors with metadata | :heavy_check_mark: | :x: | :heavy_check_mark: | :heavy_check_mark: | :x: |
189
+ | JSON mode | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
190
+ | Custom defaults | :heavy_check_mark: | :x: | :heavy_check_mark: | :heavy_check_mark: | :x: |
191
+ | Composable | :heavy_check_mark: | :x: | :x: | :x: | :heavy_check_mark: |
192
+ | Hooks | :heavy_check_mark: | :x: | :heavy_check_mark: | :heavy_check_mark: | :x: |
193
+ | Issues open | [![][gio]][g1] | [![][nio]][n1] | [![][kio]][k1] | [![][aio]][a1] | [![][sio]][s1] |
194
+ | Issues closed | [![][gic]][g2] | [![][nic]][n2] | [![][kic]][k2] | [![][aic]][a2] | [![][sic]][s2] |
195
+ | Downloads | [![][gd]][g3] | [![][nd]][n3] | [![][kd]][k3] | [![][ad]][a3] | [![][sd]][s3] |
196
+ | Coverage | TBD | [![][nc]][n4] | [![][kc]][k4] | [![][ac]][a4] | [![][sc]][s4] |
197
+ | Build | [![][gb]][g5] | [![][nb]][n5] | [![][kb]][k5] | [![][ab]][a5] | [![][sb]][s5] |
198
+ | Bugs | [![][gbg]][g6] | [![][nbg]][n6] | [![][kbg]][k6] | [![][abg]][a6] | [![][sbg]][s6] |
199
+ | Dependents | [![][gdp]][g7] | [![][ndp]][n7] | [![][kdp]][k7] | [![][adp]][a7] | [![][sdp]][s7] |
200
+ | Install size | [![][gis]][g8] | [![][nis]][n8] | [![][kis]][k8] | [![][ais]][a8] | [![][sis]][s8] |
201
+ | GitHub stars | [![][gs]][g9] | [![][ns]][n9] | [![][ks]][k9] | [![][as]][a9] | [![][ss]][s9] |
202
+ | TypeScript support | [![][gts]][g10] | [![][nts]][n10] | [![][kts]][k10] | [![][ats]][a10] | [![][sts]][s11] |
203
+ | Last commit | [![][glc]][g11] | [![][nlc]][n11] | [![][klc]][k11] | [![][alc]][a11] | [![][slc]][s11] |
204
+
205
+ \* It's almost API compatible with the browser `fetch` API.\
206
+ \*\* Need to switch the protocol manually. Doesn't accept PUSH streams and doesn't reuse HTTP/2 sessions.\
207
+ ¹ Requires Node.js 15.10.0 or above.\
208
+ :sparkle: Almost-stable feature, but the API may change. Don't hesitate to try it out!\
209
+ :grey_question: Feature in early stage of development. Very experimental.
210
+
211
+ <!-- GITHUB -->
212
+ [k0]: https://github.com/sindresorhus/ky
213
+ [n0]: https://github.com/node-fetch/node-fetch
214
+ [a0]: https://github.com/axios/axios
215
+ [s0]: https://github.com/visionmedia/superagent
216
+
217
+ <!-- ISSUES OPEN -->
218
+ [gio]: https://img.shields.io/github/issues-raw/sindresorhus/got?color=gray&label
219
+ [kio]: https://img.shields.io/github/issues-raw/sindresorhus/ky?color=gray&label
220
+ [nio]: https://img.shields.io/github/issues-raw/bitinn/node-fetch?color=gray&label
221
+ [aio]: https://img.shields.io/github/issues-raw/axios/axios?color=gray&label
222
+ [sio]: https://img.shields.io/github/issues-raw/visionmedia/superagent?color=gray&label
223
+
224
+ [g1]: https://github.com/sindresorhus/got/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
225
+ [k1]: https://github.com/sindresorhus/ky/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
226
+ [n1]: https://github.com/bitinn/node-fetch/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
227
+ [a1]: https://github.com/axios/axios/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
228
+ [s1]: https://github.com/visionmedia/superagent/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
229
+
230
+ <!-- ISSUES CLOSED -->
231
+ [gic]: https://img.shields.io/github/issues-closed-raw/sindresorhus/got?color=blue&label
232
+ [kic]: https://img.shields.io/github/issues-closed-raw/sindresorhus/ky?color=blue&label
233
+ [nic]: https://img.shields.io/github/issues-closed-raw/bitinn/node-fetch?color=blue&label
234
+ [aic]: https://img.shields.io/github/issues-closed-raw/axios/axios?color=blue&label
235
+ [sic]: https://img.shields.io/github/issues-closed-raw/visionmedia/superagent?color=blue&label
236
+
237
+ [g2]: https://github.com/sindresorhus/got/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
238
+ [k2]: https://github.com/sindresorhus/ky/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
239
+ [n2]: https://github.com/bitinn/node-fetch/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
240
+ [a2]: https://github.com/axios/axios/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
241
+ [s2]: https://github.com/visionmedia/superagent/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
242
+
243
+ <!-- DOWNLOADS -->
244
+ [gd]: https://img.shields.io/npm/dm/got?color=darkgreen&label
245
+ [kd]: https://img.shields.io/npm/dm/ky?color=darkgreen&label
246
+ [nd]: https://img.shields.io/npm/dm/node-fetch?color=darkgreen&label
247
+ [ad]: https://img.shields.io/npm/dm/axios?color=darkgreen&label
248
+ [sd]: https://img.shields.io/npm/dm/superagent?color=darkgreen&label
249
+
250
+ [g3]: https://www.npmjs.com/package/got
251
+ [k3]: https://www.npmjs.com/package/ky
252
+ [n3]: https://www.npmjs.com/package/node-fetch
253
+ [a3]: https://www.npmjs.com/package/axios
254
+ [s3]: https://www.npmjs.com/package/superagent
255
+
256
+ <!-- COVERAGE -->
257
+ [gc]: https://img.shields.io/coveralls/github/sindresorhus/got?color=0b9062&label
258
+ [kc]: https://img.shields.io/codecov/c/github/sindresorhus/ky?color=0b9062&label
259
+ [nc]: https://img.shields.io/coveralls/github/bitinn/node-fetch?color=0b9062&label
260
+ [ac]: https://img.shields.io/coveralls/github/mzabriskie/axios?color=0b9062&label
261
+ [sc]: https://img.shields.io/codecov/c/github/visionmedia/superagent?color=0b9062&label
262
+
263
+ [g4]: https://coveralls.io/github/sindresorhus/got
264
+ [k4]: https://codecov.io/gh/sindresorhus/ky
265
+ [n4]: https://coveralls.io/github/bitinn/node-fetch
266
+ [a4]: https://coveralls.io/github/mzabriskie/axios
267
+ [s4]: https://codecov.io/gh/visionmedia/superagent
268
+
269
+ <!-- BUILD -->
270
+ [gb]: https://github.com/sindresorhus/got/actions/workflows/main.yml/badge.svg
271
+ [kb]: https://github.com/sindresorhus/ky/actions/workflows/main.yml/badge.svg
272
+ [nb]: https://img.shields.io/travis/bitinn/node-fetch?label
273
+ [ab]: https://img.shields.io/travis/axios/axios?label
274
+ [sb]: https://img.shields.io/travis/visionmedia/superagent?label
275
+
276
+ [g5]: https://github.com/sindresorhus/got/actions/workflows/main.yml
277
+ [k5]: https://github.com/sindresorhus/ky/actions/workflows/main.yml
278
+ [n5]: https://travis-ci.org/github/bitinn/node-fetch
279
+ [a5]: https://travis-ci.org/github/axios/axios
280
+ [s5]: https://travis-ci.org/github/visionmedia/superagent
281
+
282
+ <!-- BUGS -->
283
+ [gbg]: https://img.shields.io/github/issues-raw/sindresorhus/got/bug?color=darkred&label
284
+ [kbg]: https://img.shields.io/github/issues-raw/sindresorhus/ky/bug?color=darkred&label
285
+ [nbg]: https://img.shields.io/github/issues-raw/bitinn/node-fetch/bug?color=darkred&label
286
+ [abg]: https://img.shields.io/github/issues-raw/axios/axios/bug-fix?color=darkred&label
287
+ [sbg]: https://img.shields.io/github/issues-raw/visionmedia/superagent/Bug?color=darkred&label
288
+
289
+ [g6]: https://github.com/sindresorhus/got/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Abug
290
+ [k6]: https://github.com/sindresorhus/ky/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Abug
291
+ [n6]: https://github.com/bitinn/node-fetch/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Abug
292
+ [a6]: https://github.com/axios/axios/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22bug-fix%22
293
+ [s6]: https://github.com/visionmedia/superagent/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3ABug
294
+
295
+ <!-- DEPENDENTS -->
296
+ [gdp]: https://badgen.net/npm/dependents/got?color=orange&label
297
+ [kdp]: https://badgen.net/npm/dependents/ky?color=orange&label
298
+ [ndp]: https://badgen.net/npm/dependents/node-fetch?color=orange&label
299
+ [adp]: https://badgen.net/npm/dependents/axios?color=orange&label
300
+ [sdp]: https://badgen.net/npm/dependents/superagent?color=orange&label
301
+
302
+ [g7]: https://www.npmjs.com/package/got?activeTab=dependents
303
+ [k7]: https://www.npmjs.com/package/ky?activeTab=dependents
304
+ [n7]: https://www.npmjs.com/package/node-fetch?activeTab=dependents
305
+ [a7]: https://www.npmjs.com/package/axios?activeTab=dependents
306
+ [s7]: https://www.npmjs.com/package/visionmedia?activeTab=dependents
307
+
308
+ <!-- INSTALL SIZE -->
309
+ [gis]: https://packagephobia.com/badge?p=got
310
+ [kis]: https://packagephobia.com/badge?p=ky
311
+ [nis]: https://packagephobia.com/badge?p=node-fetch
312
+ [ais]: https://packagephobia.com/badge?p=axios
313
+ [sis]: https://packagephobia.com/badge?p=superagent
314
+
315
+ [g8]: https://packagephobia.com/result?p=got
316
+ [k8]: https://packagephobia.com/result?p=ky
317
+ [n8]: https://packagephobia.com/result?p=node-fetch
318
+ [a8]: https://packagephobia.com/result?p=axios
319
+ [s8]: https://packagephobia.com/result?p=superagent
320
+
321
+ <!-- GITHUB STARS -->
322
+ [gs]: https://img.shields.io/github/stars/sindresorhus/got?color=white&label
323
+ [ks]: https://img.shields.io/github/stars/sindresorhus/ky?color=white&label
324
+ [ns]: https://img.shields.io/github/stars/bitinn/node-fetch?color=white&label
325
+ [as]: https://img.shields.io/github/stars/axios/axios?color=white&label
326
+ [ss]: https://img.shields.io/github/stars/visionmedia/superagent?color=white&label
327
+
328
+ [g9]: https://github.com/sindresorhus/got
329
+ [k9]: https://github.com/sindresorhus/ky
330
+ [n9]: https://github.com/node-fetch/node-fetch
331
+ [a9]: https://github.com/axios/axios
332
+ [s9]: https://github.com/visionmedia/superagent
333
+
334
+ <!-- TYPESCRIPT SUPPORT -->
335
+ [gts]: https://badgen.net/npm/types/got?label
336
+ [kts]: https://badgen.net/npm/types/ky?label
337
+ [nts]: https://badgen.net/npm/types/node-fetch?label
338
+ [ats]: https://badgen.net/npm/types/axios?label
339
+ [sts]: https://badgen.net/npm/types/superagent?label
340
+
341
+ [g10]: https://github.com/sindresorhus/got
342
+ [k10]: https://github.com/sindresorhus/ky
343
+ [n10]: https://github.com/node-fetch/node-fetch
344
+ [a10]: https://github.com/axios/axios
345
+ [s10]: https://github.com/visionmedia/superagent
346
+
347
+ <!-- LAST COMMIT -->
348
+ [glc]: https://img.shields.io/github/last-commit/sindresorhus/got?color=gray&label
349
+ [klc]: https://img.shields.io/github/last-commit/sindresorhus/ky?color=gray&label
350
+ [nlc]: https://img.shields.io/github/last-commit/bitinn/node-fetch?color=gray&label
351
+ [alc]: https://img.shields.io/github/last-commit/axios/axios?color=gray&label
352
+ [slc]: https://img.shields.io/github/last-commit/visionmedia/superagent?color=gray&label
353
+
354
+ [g11]: https://github.com/sindresorhus/got/commits
355
+ [k11]: https://github.com/sindresorhus/ky/commits
356
+ [n11]: https://github.com/node-fetch/node-fetch/commits
357
+ [a11]: https://github.com/axios/axios/commits
358
+ [s11]: https://github.com/visionmedia/superagent/commits
359
+
360
+ [Click here][InstallSizeOfTheDependencies] to see the install size of the Got dependencies.
361
+
362
+ [InstallSizeOfTheDependencies]: https://packagephobia.com/result?p=@sindresorhus/is@7.0.0,@szmarczak/http-timer@5.0.1,cacheable-lookup@7.0.0,cacheable-request@12.0.1,decompress-response@6.0.0,form-data-encoder@4.0.2,http2-wrapper@2.2.1,lowercase-keys@3.0.0,p-cancelable@4.0.1,responselike@3.0.0,type-fest@4.19.0
363
+
364
+ ## Maintainers
365
+
366
+ [![Sindre Sorhus](https://github.com/sindresorhus.png?size=100)](https://sindresorhus.com) | [![Szymon Marczak](https://github.com/szmarczak.png?size=100)](https://github.com/szmarczak)
367
+ ---|---
368
+ [Sindre Sorhus](https://sindresorhus.com) | [Szymon Marczak](https://github.com/szmarczak)
369
+
370
+ <a name="widely-used"></a>
371
+ ## These amazing companies are using Got
372
+
373
+ <table>
374
+ <tbody>
375
+ <tr>
376
+ <td align="center">
377
+ <a href="https://segment.com">
378
+ <img width="90" valign="middle" src="https://user-images.githubusercontent.com/697676/47693700-ddb62500-dbb7-11e8-8332-716a91010c2d.png">
379
+ </a>
380
+ </td>
381
+ <td align="center">
382
+ <a href="https://antora.org">
383
+ <img width="100" valign="middle" src="https://user-images.githubusercontent.com/79351/47706840-d874cc80-dbef-11e8-87c6-5f0c60cbf5dc.png">
384
+ </a>
385
+ </td>
386
+ <td align="center">
387
+ <a href="https://getvoip.com">
388
+ <img width="150" valign="middle" src="https://user-images.githubusercontent.com/10832620/47869404-429e9480-dddd-11e8-8a7a-ca43d7f06020.png">
389
+ </a>
390
+ </td>
391
+ <td align="center">
392
+ <a href="https://github.com/exoframejs/exoframe">
393
+ <img width="150" valign="middle" src="https://user-images.githubusercontent.com/365944/47791460-11a95b80-dd1a-11e8-9070-e8f2a215e03a.png">
394
+ </a>
395
+ </td>
396
+ </tr>
397
+ <tr>
398
+ <td align="center">
399
+ <a href="http://karaokes.moe">
400
+ <img width="140" valign="middle" src="https://karaokes.moe/assets/images/index.png">
401
+ </a>
402
+ </td>
403
+ <td align="center">
404
+ <a href="https://github.com/renovatebot/renovate">
405
+ <img width="150" valign="middle" src="https://avatars.githubusercontent.com/u/38656520?s=200&v=4">
406
+ </a>
407
+ </td>
408
+ <td align="center">
409
+ <a href="https://resist.bot">
410
+ <img width="150" valign="middle" src="https://user-images.githubusercontent.com/3322287/51992724-28736180-2473-11e9-9764-599cfda4b012.png">
411
+ </a>
412
+ </td>
413
+ <td align="center">
414
+ <a href="https://www.naturalcycles.com">
415
+ <img width="150" valign="middle" src="https://user-images.githubusercontent.com/170270/92244143-d0a8a200-eec2-11ea-9fc0-1c07f90b2113.png">
416
+ </a>
417
+ </td>
418
+ </tr>
419
+ <tr>
420
+ <td align="center">
421
+ <a href="https://microlink.io">
422
+ <img width="150" valign="middle" src="https://user-images.githubusercontent.com/36894700/91992974-1cc5dc00-ed35-11ea-9d04-f58b42ce6a5e.png">
423
+ </a>
424
+ </td>
425
+ <td align="center">
426
+ <a href="https://radity.com">
427
+ <img width="150" valign="middle" src="https://user-images.githubusercontent.com/29518613/91814036-97fb9500-ec44-11ea-8c6c-d198cc23ca29.png">
428
+ </a>
429
+ </td>
430
+ </tr>
431
+ </tbody>
432
+ </table>
433
+
434
+ <!-- <br> -->
435
+
436
+ <!-- *Creating an awesome product? Open an issue to get listed here.* -->
437
+
438
+ <br>
439
+
440
+ > Segment is a happy user of Got! Got powers the main backend API that our app talks to. It's used by our in-house RPC client that we use to communicate with all microservices.
441
+ >
442
+ > — <a href="https://github.com/vadimdemedes">Vadim Demedes</a>
443
+
444
+ > Antora, a static site generator for creating documentation sites, uses Got to download the UI bundle. In Antora, the UI bundle (aka theme) is maintained as a separate project. That project exports the UI as a zip file we call the UI bundle. The main site generator downloads that UI from a URL using Got and streams it to vinyl-zip to extract the files. Those files go on to be used to create the HTML pages and supporting assets.
445
+ >
446
+ > — <a href="https://github.com/mojavelinux">Dan Allen</a>
447
+
448
+ > GetVoIP is happily using Got in production. One of the unique capabilities of Got is the ability to handle Unix sockets which enables us to build a full control interfaces for our docker stack.
449
+ >
450
+ > — <a href="https://github.com/danielkalen">Daniel Kalen</a>
451
+
452
+ > We're using Got inside of Exoframe to handle all the communication between CLI and server. Exoframe is a self-hosted tool that allows simple one-command deployments using Docker.
453
+ >
454
+ > — <a href="https://github.com/yamalight">Tim Ermilov</a>
455
+
456
+ > Karaoke Mugen uses Got to fetch content updates from its online server.
457
+ >
458
+ > — <a href="https://github.com/AxelTerizaki">Axel Terizaki</a>
459
+
460
+ > Renovate uses Got, gh-got and gl-got to send millions of queries per day to GitHub, GitLab, npmjs, PyPi, Packagist, Docker Hub, Terraform, CircleCI, and more.
461
+ >
462
+ > — <a href="https://github.com/rarkins">Rhys Arkins</a>
463
+
464
+ > Resistbot uses Got to communicate from the API frontend where all correspondence ingresses to the officials lookup database in back.
465
+ >
466
+ > — <a href="https://github.com/chris-erickson">Chris Erickson</a>
467
+
468
+ > Natural Cycles is using Got to communicate with all kinds of 3rd-party REST APIs (over 9000!).
469
+ >
470
+ > — <a href="https://github.com/kirillgroshkov">Kirill Groshkov</a>
471
+
472
+ > Microlink is a cloud browser as an API service that uses Got widely as the main HTTP client, serving ~22M requests a month, every time a network call needs to be performed.
473
+ >
474
+ > — <a href="https://github.com/Kikobeats">Kiko Beats</a>
475
+
476
+ > We’re using Got at Radity. Thanks for such an amazing work!
477
+ >
478
+ > — <a href="https://github.com/MirzayevFarid">Mirzayev Farid</a>