| 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 | </p>
|
| 26 | <hr>
|
| 27 | <br>
|
| 28 | <br>
|
| 29 | <br>
|
| 30 | <br>
|
| 31 | <br>
|
| 32 | <br>
|
| 33 | <br>
|
| 34 | </div>
|
| 35 |
|
| 36 | > Human-friendly and powerful HTTP request library for Node.js
|
| 37 |
|
| 38 |
|
| 39 | [](https://npmjs.com/got)
|
| 40 | [](https://packagephobia.com/result?p=got)
|
| 41 |
|
| 42 | [See how Got compares to other HTTP libraries](#comparison)
|
| 43 |
|
| 44 | ---
|
| 45 |
|
| 46 | **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.**
|
| 47 |
|
| 48 | ---
|
| 49 |
|
| 50 | **Support questions should be asked [here](https://github.com/sindresorhus/got/discussions).**
|
| 51 |
|
| 52 | ## Install
|
| 53 |
|
| 54 | ```sh
|
| 55 | npm install got
|
| 56 | ```
|
| 57 |
|
| 58 | **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.
|
| 59 |
|
| 60 | **Got v11 is no longer maintained and we will not accept any backport requests.**
|
| 61 |
|
| 62 | ## Take a peek
|
| 63 |
|
| 64 | **A [quick start](documentation/quick-start.md) guide is available.**
|
| 65 |
|
| 66 | ### JSON mode
|
| 67 |
|
| 68 | Got has a dedicated option for handling JSON payload.\
|
| 69 | Furthermore, the promise exposes a `.json<T>()` function that returns `Promise<T>`.
|
| 70 |
|
| 71 | ```js
|
| 72 | import got from 'got';
|
| 73 |
|
| 74 | const {data} = await got.post('https://httpbin.org/anything', {
|
| 75 | json: {
|
| 76 | hello: 'world'
|
| 77 | }
|
| 78 | }).json();
|
| 79 |
|
| 80 | console.log(data);
|
| 81 | //=> {"hello": "world"}
|
| 82 | ```
|
| 83 |
|
| 84 | For advanced JSON usage, check out the [`parseJson`](documentation/2-options.md#parsejson) and [`stringifyJson`](documentation/2-options.md#stringifyjson) options.
|
| 85 |
|
| 86 | **For more useful tips like this, visit the [Tips](documentation/tips.md) page.**
|
| 87 |
|
| 88 | ## Highlights
|
| 89 |
|
| 90 | - [Used by 10K+ packages and 5M+ repos](https://github.com/sindresorhus/got/network/dependents)
|
| 91 | - [Actively maintained](https://github.com/sindresorhus/got/graphs/contributors)
|
| 92 | - [Trusted by many companies](#widely-used)
|
| 93 |
|
| 94 | ## Documentation
|
| 95 |
|
| 96 | By default, Got will retry on failure. To disable this option, set [`options.retry.limit`](documentation/7-retry.md#retry) to 0.
|
| 97 |
|
| 98 | #### Main API
|
| 99 |
|
| 100 | - [x] [Promise API](documentation/1-promise.md)
|
| 101 | - [x] [Options](documentation/2-options.md)
|
| 102 | - [x] [Stream API](documentation/3-streams.md)
|
| 103 | - [x] [Pagination API](documentation/4-pagination.md)
|
| 104 | - [x] [Advanced HTTPS API](documentation/5-https.md)
|
| 105 | - [x] [HTTP/2 support](documentation/2-options.md#http2)
|
| 106 | - [x] [`Response` class](documentation/3-streams.md#response-2)
|
| 107 |
|
| 108 | #### Timeouts and retries
|
| 109 |
|
| 110 | - [x] [Advanced timeout handling](documentation/6-timeout.md)
|
| 111 | - [x] [Retries on failure](documentation/7-retry.md)
|
| 112 | - [x] [Errors with metadata](documentation/8-errors.md)
|
| 113 |
|
| 114 | #### Advanced creation
|
| 115 |
|
| 116 | - [x] [Hooks](documentation/9-hooks.md)
|
| 117 | - [x] [Instances](documentation/10-instances.md)
|
| 118 | - [x] [Progress events & other events](documentation/3-streams.md#events)
|
| 119 | - [x] [Plugins](documentation/lets-make-a-plugin.md)
|
| 120 | - [x] [Compose](documentation/examples/advanced-creation.js)
|
| 121 |
|
| 122 | #### Cache, Proxy and UNIX sockets
|
| 123 |
|
| 124 | - [x] [RFC compliant caching](documentation/cache.md)
|
| 125 | - [x] [Proxy support](documentation/tips.md#proxying)
|
| 126 | - [x] [Unix Domain Sockets](documentation/2-options.md#enableunixsockets)
|
| 127 |
|
| 128 | #### Integration
|
| 129 |
|
| 130 | - [x] [TypeScript support](documentation/typescript.md)
|
| 131 | - [x] [AWS](documentation/tips.md#aws)
|
| 132 | - [x] [Testing](documentation/tips.md#testing)
|
| 133 |
|
| 134 | ---
|
| 135 |
|
| 136 | ### Migration guides
|
| 137 |
|
| 138 | - [Request migration guide](documentation/migration-guides/request.md)
|
| 139 | - [*(Note that Request is unmaintained)*](https://github.com/request/request/issues/3142)
|
| 140 | - [Axios](documentation/migration-guides/axios.md)
|
| 141 | - [Node.js](documentation/migration-guides/nodejs.md)
|
| 142 |
|
| 143 | ## Got plugins
|
| 144 |
|
| 145 | - [`got4aws`](https://github.com/SamVerschueren/got4aws) - Got convenience wrapper to interact with AWS v4 signed APIs
|
| 146 | - [`gh-got`](https://github.com/sindresorhus/gh-got) - Got convenience wrapper to interact with the GitHub API
|
| 147 | - [`gl-got`](https://github.com/singapore/gl-got) - Got convenience wrapper to interact with the GitLab API
|
| 148 | - [`gotql`](https://github.com/khaosdoctor/gotql) - Got convenience wrapper to interact with GraphQL using JSON-parsed queries instead of strings
|
| 149 | - [`got-fetch`](https://github.com/alexghr/got-fetch) - Got with a [`fetch`](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) interface
|
| 150 | - [`got-scraping`](https://github.com/apify/got-scraping) - Got wrapper specifically designed for web scraping purposes
|
| 151 | - [`got-ssrf`](https://github.com/JaneJeon/got-ssrf) - Got wrapper to protect server-side requests against SSRF attacks
|
| 152 |
|
| 153 | ## Comparison
|
| 154 |
|
| 155 | | | `got` | [`node-fetch`][n0] | [`ky`][k0] | [`axios`][a0] | [`superagent`][s0] |
|
| 156 | |-----------------------|:-------------------:|:--------------------:|:------------------------:|:------------------:|:----------------------:|
|
| 157 | | HTTP/2 support | :heavy_check_mark:¹ | :x: | :heavy_check_mark: | :x: | :heavy_check_mark:\*\* |
|
| 158 | | Browser support | :x: | :heavy_check_mark:\* | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 159 | | Promise API | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 160 | | Stream API | :heavy_check_mark: | Node.js only | :x: | :x: | :heavy_check_mark: |
|
| 161 | | Pagination API | :heavy_check_mark: | :x: | :x: | :x: | :x: |
|
| 162 | | Request cancelation | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 163 | | RFC compliant caching | :heavy_check_mark: | :x: | :x: | :x: | :x: |
|
| 164 | | Cookies (out-of-the-box) | :heavy_check_mark: | :x: | :x: | :x: | :x: |
|
| 165 | | Follows redirects | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 166 | | Retries on failure | :heavy_check_mark: | :x: | :heavy_check_mark: | :x: | :heavy_check_mark: |
|
| 167 | | Progress events | :heavy_check_mark: | :x: | :heavy_check_mark:\*\*\* | Browser only | :heavy_check_mark: |
|
| 168 | | Handles gzip/deflate | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 169 | | Advanced timeouts | :heavy_check_mark: | :x: | :x: | :x: | :x: |
|
| 170 | | Timings | :heavy_check_mark: | :x: | :x: | :x: | :x: |
|
| 171 | | Errors with metadata | :heavy_check_mark: | :x: | :heavy_check_mark: | :heavy_check_mark: | :x: |
|
| 172 | | JSON mode | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
|
| 173 | | Custom defaults | :heavy_check_mark: | :x: | :heavy_check_mark: | :heavy_check_mark: | :x: |
|
| 174 | | Composable | :heavy_check_mark: | :x: | :x: | :x: | :heavy_check_mark: |
|
| 175 | | Hooks | :heavy_check_mark: | :x: | :heavy_check_mark: | :heavy_check_mark: | :x: |
|
| 176 | | Issues open | [![][gio]][g1] | [![][nio]][n1] | [![][kio]][k1] | [![][aio]][a1] | [![][sio]][s1] |
|
| 177 | | Issues closed | [![][gic]][g2] | [![][nic]][n2] | [![][kic]][k2] | [![][aic]][a2] | [![][sic]][s2] |
|
| 178 | | Downloads | [![][gd]][g3] | [![][nd]][n3] | [![][kd]][k3] | [![][ad]][a3] | [![][sd]][s3] |
|
| 179 | | Coverage | TBD | [![][nc]][n4] | [![][kc]][k4] | [![][ac]][a4] | [![][sc]][s4] |
|
| 180 | | Build | [![][gb]][g5] | [![][nb]][n5] | [![][kb]][k5] | [![][ab]][a5] | [![][sb]][s5] |
|
| 181 | | Bugs | [![][gbg]][g6] | [![][nbg]][n6] | [![][kbg]][k6] | [![][abg]][a6] | [![][sbg]][s6] |
|
| 182 | | Dependents | [![][gdp]][g7] | [![][ndp]][n7] | [![][kdp]][k7] | [![][adp]][a7] | [![][sdp]][s7] |
|
| 183 | | Install size | [![][gis]][g8] | [![][nis]][n8] | [![][kis]][k8] | [![][ais]][a8] | [![][sis]][s8] |
|
| 184 | | GitHub stars | [![][gs]][g9] | [![][ns]][n9] | [![][ks]][k9] | [![][as]][a9] | [![][ss]][s9] |
|
| 185 | | TypeScript support | [![][gts]][g10] | [![][nts]][n10] | [![][kts]][k10] | [![][ats]][a10] | [![][sts]][s11] |
|
| 186 | | Last commit | [![][glc]][g11] | [![][nlc]][n11] | [![][klc]][k11] | [![][alc]][a11] | [![][slc]][s11] |
|
| 187 |
|
| 188 | \* It's almost API compatible with the browser `fetch` API.\
|
| 189 | \*\* Need to switch the protocol manually. Doesn't accept PUSH streams and doesn't reuse HTTP/2 sessions.\
|
| 190 | \*\*\* Currently, only `DownloadProgress` event is supported, `UploadProgress` event is not supported.\
|
| 191 | ¹ Requires Node.js 15.10.0 or above.\
|
| 192 | :sparkle: Almost-stable feature, but the API may change. Don't hesitate to try it out!\
|
| 193 | :grey_question: Feature in early stage of development. Very experimental.
|
| 194 |
|
| 195 |
|
| 196 | [k0]: https://github.com/sindresorhus/ky
|
| 197 | [n0]: https://github.com/node-fetch/node-fetch
|
| 198 | [a0]: https://github.com/axios/axios
|
| 199 | [s0]: https://github.com/visionmedia/superagent
|
| 200 |
|
| 201 |
|
| 202 | [gio]: https://img.shields.io/github/issues-raw/sindresorhus/got?color=gray&label
|
| 203 | [kio]: https://img.shields.io/github/issues-raw/sindresorhus/ky?color=gray&label
|
| 204 | [nio]: https://img.shields.io/github/issues-raw/bitinn/node-fetch?color=gray&label
|
| 205 | [aio]: https://img.shields.io/github/issues-raw/axios/axios?color=gray&label
|
| 206 | [sio]: https://img.shields.io/github/issues-raw/visionmedia/superagent?color=gray&label
|
| 207 |
|
| 208 | [g1]: https://github.com/sindresorhus/got/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
|
| 209 | [k1]: https://github.com/sindresorhus/ky/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
|
| 210 | [n1]: https://github.com/bitinn/node-fetch/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
|
| 211 | [a1]: https://github.com/axios/axios/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
|
| 212 | [s1]: https://github.com/visionmedia/superagent/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
|
| 213 |
|
| 214 |
|
| 215 | [gic]: https://img.shields.io/github/issues-closed-raw/sindresorhus/got?color=blue&label
|
| 216 | [kic]: https://img.shields.io/github/issues-closed-raw/sindresorhus/ky?color=blue&label
|
| 217 | [nic]: https://img.shields.io/github/issues-closed-raw/bitinn/node-fetch?color=blue&label
|
| 218 | [aic]: https://img.shields.io/github/issues-closed-raw/axios/axios?color=blue&label
|
| 219 | [sic]: https://img.shields.io/github/issues-closed-raw/visionmedia/superagent?color=blue&label
|
| 220 |
|
| 221 | [g2]: https://github.com/sindresorhus/got/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
|
| 222 | [k2]: https://github.com/sindresorhus/ky/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
|
| 223 | [n2]: https://github.com/bitinn/node-fetch/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
|
| 224 | [a2]: https://github.com/axios/axios/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
|
| 225 | [s2]: https://github.com/visionmedia/superagent/issues?q=is%3Aissue+is%3Aclosed+sort%3Aupdated-desc
|
| 226 |
|
| 227 |
|
| 228 | [gd]: https://img.shields.io/npm/dm/got?color=darkgreen&label
|
| 229 | [kd]: https://img.shields.io/npm/dm/ky?color=darkgreen&label
|
| 230 | [nd]: https://img.shields.io/npm/dm/node-fetch?color=darkgreen&label
|
| 231 | [ad]: https://img.shields.io/npm/dm/axios?color=darkgreen&label
|
| 232 | [sd]: https://img.shields.io/npm/dm/superagent?color=darkgreen&label
|
| 233 |
|
| 234 | [g3]: https://www.npmjs.com/package/got
|
| 235 | [k3]: https://www.npmjs.com/package/ky
|
| 236 | [n3]: https://www.npmjs.com/package/node-fetch
|
| 237 | [a3]: https://www.npmjs.com/package/axios
|
| 238 | [s3]: https://www.npmjs.com/package/superagent
|
| 239 |
|
| 240 |
|
| 241 | [gc]: https://img.shields.io/coveralls/github/sindresorhus/got?color=0b9062&label
|
| 242 | [kc]: https://img.shields.io/codecov/c/github/sindresorhus/ky?color=0b9062&label
|
| 243 | [nc]: https://img.shields.io/coveralls/github/bitinn/node-fetch?color=0b9062&label
|
| 244 | [ac]: https://img.shields.io/coveralls/github/mzabriskie/axios?color=0b9062&label
|
| 245 | [sc]: https://img.shields.io/codecov/c/github/visionmedia/superagent?color=0b9062&label
|
| 246 |
|
| 247 | [g4]: https://coveralls.io/github/sindresorhus/got
|
| 248 | [k4]: https://codecov.io/gh/sindresorhus/ky
|
| 249 | [n4]: https://coveralls.io/github/bitinn/node-fetch
|
| 250 | [a4]: https://coveralls.io/github/mzabriskie/axios
|
| 251 | [s4]: https://codecov.io/gh/visionmedia/superagent
|
| 252 |
|
| 253 |
|
| 254 | [gb]: https://github.com/sindresorhus/got/actions/workflows/main.yml/badge.svg
|
| 255 | [kb]: https://github.com/sindresorhus/ky/actions/workflows/main.yml/badge.svg
|
| 256 | [nb]: https://img.shields.io/travis/bitinn/node-fetch?label
|
| 257 | [ab]: https://img.shields.io/travis/axios/axios?label
|
| 258 | [sb]: https://img.shields.io/travis/visionmedia/superagent?label
|
| 259 |
|
| 260 | [g5]: https://github.com/sindresorhus/got/actions/workflows/main.yml
|
| 261 | [k5]: https://github.com/sindresorhus/ky/actions/workflows/main.yml
|
| 262 | [n5]: https://travis-ci.org/github/bitinn/node-fetch
|
| 263 | [a5]: https://travis-ci.org/github/axios/axios
|
| 264 | [s5]: https://travis-ci.org/github/visionmedia/superagent
|
| 265 |
|
| 266 |
|
| 267 | [gbg]: https://img.shields.io/github/issues-raw/sindresorhus/got/bug?color=darkred&label
|
| 268 | [kbg]: https://img.shields.io/github/issues-raw/sindresorhus/ky/bug?color=darkred&label
|
| 269 | [nbg]: https://img.shields.io/github/issues-raw/bitinn/node-fetch/bug?color=darkred&label
|
| 270 | [abg]: https://img.shields.io/github/issues-raw/axios/axios/bug-fix?color=darkred&label
|
| 271 | [sbg]: https://img.shields.io/github/issues-raw/visionmedia/superagent/Bug?color=darkred&label
|
| 272 |
|
| 273 | [g6]: https://github.com/sindresorhus/got/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Abug
|
| 274 | [k6]: https://github.com/sindresorhus/ky/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Abug
|
| 275 | [n6]: https://github.com/bitinn/node-fetch/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Abug
|
| 276 | [a6]: https://github.com/axios/axios/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22bug-fix%22
|
| 277 | [s6]: https://github.com/visionmedia/superagent/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3ABug
|
| 278 |
|
| 279 |
|
| 280 | [gdp]: https://badgen.net/npm/dependents/got?color=orange&label
|
| 281 | [kdp]: https://badgen.net/npm/dependents/ky?color=orange&label
|
| 282 | [ndp]: https://badgen.net/npm/dependents/node-fetch?color=orange&label
|
| 283 | [adp]: https://badgen.net/npm/dependents/axios?color=orange&label
|
| 284 | [sdp]: https://badgen.net/npm/dependents/superagent?color=orange&label
|
| 285 |
|
| 286 | [g7]: https://www.npmjs.com/package/got?activeTab=dependents
|
| 287 | [k7]: https://www.npmjs.com/package/ky?activeTab=dependents
|
| 288 | [n7]: https://www.npmjs.com/package/node-fetch?activeTab=dependents
|
| 289 | [a7]: https://www.npmjs.com/package/axios?activeTab=dependents
|
| 290 | [s7]: https://www.npmjs.com/package/visionmedia?activeTab=dependents
|
| 291 |
|
| 292 |
|
| 293 | [gis]: https://packagephobia.com/badge?p=got
|
| 294 | [kis]: https://packagephobia.com/badge?p=ky
|
| 295 | [nis]: https://packagephobia.com/badge?p=node-fetch
|
| 296 | [ais]: https://packagephobia.com/badge?p=axios
|
| 297 | [sis]: https://packagephobia.com/badge?p=superagent
|
| 298 |
|
| 299 | [g8]: https://packagephobia.com/result?p=got
|
| 300 | [k8]: https://packagephobia.com/result?p=ky
|
| 301 | [n8]: https://packagephobia.com/result?p=node-fetch
|
| 302 | [a8]: https://packagephobia.com/result?p=axios
|
| 303 | [s8]: https://packagephobia.com/result?p=superagent
|
| 304 |
|
| 305 |
|
| 306 | [gs]: https://img.shields.io/github/stars/sindresorhus/got?color=white&label
|
| 307 | [ks]: https://img.shields.io/github/stars/sindresorhus/ky?color=white&label
|
| 308 | [ns]: https://img.shields.io/github/stars/bitinn/node-fetch?color=white&label
|
| 309 | [as]: https://img.shields.io/github/stars/axios/axios?color=white&label
|
| 310 | [ss]: https://img.shields.io/github/stars/visionmedia/superagent?color=white&label
|
| 311 |
|
| 312 | [g9]: https://github.com/sindresorhus/got
|
| 313 | [k9]: https://github.com/sindresorhus/ky
|
| 314 | [n9]: https://github.com/node-fetch/node-fetch
|
| 315 | [a9]: https://github.com/axios/axios
|
| 316 | [s9]: https://github.com/visionmedia/superagent
|
| 317 |
|
| 318 |
|
| 319 | [gts]: https://badgen.net/npm/types/got?label
|
| 320 | [kts]: https://badgen.net/npm/types/ky?label
|
| 321 | [nts]: https://badgen.net/npm/types/node-fetch?label
|
| 322 | [ats]: https://badgen.net/npm/types/axios?label
|
| 323 | [sts]: https://badgen.net/npm/types/superagent?label
|
| 324 |
|
| 325 | [g10]: https://github.com/sindresorhus/got
|
| 326 | [k10]: https://github.com/sindresorhus/ky
|
| 327 | [n10]: https://github.com/node-fetch/node-fetch
|
| 328 | [a10]: https://github.com/axios/axios
|
| 329 | [s10]: https://github.com/visionmedia/superagent
|
| 330 |
|
| 331 |
|
| 332 | [glc]: https://img.shields.io/github/last-commit/sindresorhus/got?color=gray&label
|
| 333 | [klc]: https://img.shields.io/github/last-commit/sindresorhus/ky?color=gray&label
|
| 334 | [nlc]: https://img.shields.io/github/last-commit/bitinn/node-fetch?color=gray&label
|
| 335 | [alc]: https://img.shields.io/github/last-commit/axios/axios?color=gray&label
|
| 336 | [slc]: https://img.shields.io/github/last-commit/visionmedia/superagent?color=gray&label
|
| 337 |
|
| 338 | [g11]: https://github.com/sindresorhus/got/commits
|
| 339 | [k11]: https://github.com/sindresorhus/ky/commits
|
| 340 | [n11]: https://github.com/node-fetch/node-fetch/commits
|
| 341 | [a11]: https://github.com/axios/axios/commits
|
| 342 | [s11]: https://github.com/visionmedia/superagent/commits
|
| 343 |
|
| 344 | [Click here][InstallSizeOfTheDependencies] to see the install size of the Got dependencies.
|
| 345 |
|
| 346 | [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
|
| 347 |
|
| 348 | ## Maintainers
|
| 349 |
|
| 350 | [](https://sindresorhus.com) | [](https://github.com/szmarczak)
|
| 351 | ---|---
|
| 352 | [Sindre Sorhus](https://sindresorhus.com) | [Szymon Marczak](https://github.com/szmarczak)
|
| 353 |
|
| 354 | <a name="widely-used"></a>
|
| 355 | ## These amazing companies are using Got
|
| 356 |
|
| 357 | <table>
|
| 358 | <tbody>
|
| 359 | <tr>
|
| 360 | <td align="center">
|
| 361 | <a href="https://segment.com">
|
| 362 | <img width="90" valign="middle" src="https://user-images.githubusercontent.com/697676/47693700-ddb62500-dbb7-11e8-8332-716a91010c2d.png">
|
| 363 | </a>
|
| 364 | </td>
|
| 365 | <td align="center">
|
| 366 | <a href="https://antora.org">
|
| 367 | <img width="100" valign="middle" src="https://user-images.githubusercontent.com/79351/47706840-d874cc80-dbef-11e8-87c6-5f0c60cbf5dc.png">
|
| 368 | </a>
|
| 369 | </td>
|
| 370 | <td align="center">
|
| 371 | <a href="https://getvoip.com">
|
| 372 | <img width="150" valign="middle" src="https://user-images.githubusercontent.com/10832620/47869404-429e9480-dddd-11e8-8a7a-ca43d7f06020.png">
|
| 373 | </a>
|
| 374 | </td>
|
| 375 | <td align="center">
|
| 376 | <a href="https://github.com/exoframejs/exoframe">
|
| 377 | <img width="150" valign="middle" src="https://user-images.githubusercontent.com/365944/47791460-11a95b80-dd1a-11e8-9070-e8f2a215e03a.png">
|
| 378 | </a>
|
| 379 | </td>
|
| 380 | </tr>
|
| 381 | <tr>
|
| 382 | <td align="center">
|
| 383 | <a href="http://karaokes.moe">
|
| 384 | <img width="140" valign="middle" src="https://karaokes.moe/assets/images/index.png">
|
| 385 | </a>
|
| 386 | </td>
|
| 387 | <td align="center">
|
| 388 | <a href="https://github.com/renovatebot/renovate">
|
| 389 | <img width="150" valign="middle" src="https://avatars.githubusercontent.com/u/38656520?s=200&v=4">
|
| 390 | </a>
|
| 391 | </td>
|
| 392 | <td align="center">
|
| 393 | <a href="https://resist.bot">
|
| 394 | <img width="150" valign="middle" src="https://user-images.githubusercontent.com/3322287/51992724-28736180-2473-11e9-9764-599cfda4b012.png">
|
| 395 | </a>
|
| 396 | </td>
|
| 397 | <td align="center">
|
| 398 | <a href="https://www.naturalcycles.com">
|
| 399 | <img width="150" valign="middle" src="https://user-images.githubusercontent.com/170270/92244143-d0a8a200-eec2-11ea-9fc0-1c07f90b2113.png">
|
| 400 | </a>
|
| 401 | </td>
|
| 402 | </tr>
|
| 403 | <tr>
|
| 404 | <td align="center">
|
| 405 | <a href="https://microlink.io">
|
| 406 | <img width="150" valign="middle" src="https://user-images.githubusercontent.com/36894700/91992974-1cc5dc00-ed35-11ea-9d04-f58b42ce6a5e.png">
|
| 407 | </a>
|
| 408 | </td>
|
| 409 | <td align="center">
|
| 410 | <a href="https://radity.com">
|
| 411 | <img width="150" valign="middle" src="https://user-images.githubusercontent.com/29518613/91814036-97fb9500-ec44-11ea-8c6c-d198cc23ca29.png">
|
| 412 | </a>
|
| 413 | </td>
|
| 414 | </tr>
|
| 415 | </tbody>
|
| 416 | </table>
|
| 417 |
|
| 418 | -->
|
| 419 |
|
| 420 |
|
| 421 |
|
| 422 | <br>
|
| 423 |
|
| 424 | > 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.
|
| 425 | >
|
| 426 | > — <a href="https://github.com/vadimdemedes">Vadim Demedes</a>
|
| 427 |
|
| 428 | > 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.
|
| 429 | >
|
| 430 | > — <a href="https://github.com/mojavelinux">Dan Allen</a>
|
| 431 |
|
| 432 | > 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.
|
| 433 | >
|
| 434 | > — <a href="https://github.com/danielkalen">Daniel Kalen</a>
|
| 435 |
|
| 436 | > 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.
|
| 437 | >
|
| 438 | > — <a href="https://github.com/yamalight">Tim Ermilov</a>
|
| 439 |
|
| 440 | > Karaoke Mugen uses Got to fetch content updates from its online server.
|
| 441 | >
|
| 442 | > — <a href="https://github.com/AxelTerizaki">Axel Terizaki</a>
|
| 443 |
|
| 444 | > 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.
|
| 445 | >
|
| 446 | > — <a href="https://github.com/rarkins">Rhys Arkins</a>
|
| 447 |
|
| 448 | > Resistbot uses Got to communicate from the API frontend where all correspondence ingresses to the officials lookup database in back.
|
| 449 | >
|
| 450 | > — <a href="https://github.com/chris-erickson">Chris Erickson</a>
|
| 451 |
|
| 452 | > Natural Cycles is using Got to communicate with all kinds of 3rd-party REST APIs (over 9000!).
|
| 453 | >
|
| 454 | > — <a href="https://github.com/kirillgroshkov">Kirill Groshkov</a>
|
| 455 |
|
| 456 | > 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.
|
| 457 | >
|
| 458 | > — <a href="https://github.com/Kikobeats">Kiko Beats</a>
|
| 459 |
|
| 460 | > We’re using Got at Radity. Thanks for such an amazing work!
|
| 461 | >
|
| 462 | > — <a href="https://github.com/MirzayevFarid">Mirzayev Farid</a>
|