ky-universal

Use Ky in both Node.js and browsers

Ky is made for browsers, but this package makes it possible to use it in Node.js too, by polyfilling most of the required browser APIs using node-fetch.

This package can be useful for:

• Isomorphic code
• Web apps (React, Vue.js, etc.) that use server-side rendering (SSR)
• Testing browser libraries using a Node.js test runner

Note: Before opening an issue, make sure it's an issue with Ky and not its polyfills. Generally, if something works in the browser, but not in Node.js, it's an issue with node-fetch.

Keep in mind that Ky targets modern browsers when used in the browser. For older browsers, you will need to transpile and use a fetch polyfill.

Install

1npm install ky ky-universal

Note that you also need to install ky.

Usage

1import ky from 'ky-universal';
2
3const parsed = await ky('https://httpbin.org/json').json();
4
5// …

ReadableStream support

For ReadableStream support, also install web-streams-polyfill:

$ npm install web-streams-polyfill

You can then use it normally:

1import ky from 'ky-universal';
2
3const {body} = await ky('https://httpbin.org/bytes/16');
4const {value} = await body.getReader().read();
5const result = new TextDecoder('utf-8').decode(value);
6
7// …

API

The API is exactly the same as the Ky API, including the named exports.

FAQ

How do I use this with a web app (React, Vue.js, etc.) that uses server-side rendering (SSR)?

Use it like you would use Ky:

1import ky from 'ky-universal';
2
3const parsed = await ky('https://httpbin.org/json').json();
4
5// …

Webpack will ensure the polyfills are only included and used when the app is rendered on the server-side.

How do I test a browser library that uses Ky in AVA?

Put the following in package.json:

1{
2	"ava": {
3		"require": [
4			"ky-universal"
5		]
6	}
7}

The library that uses Ky will now just work in AVA tests.

clone() hangs with a large response in Node - What should I do?

Streams in Node.js have a smaller internal buffer size (16 kB, aka highWaterMark) than browsers (>1 MB, not consistent across browsers). When using Ky, the default highWaterMark is set to 10 MB, so you shouldn't encounter many issues related to that.

However, you can specify a custom highWaterMark if needed:

1import ky from 'ky-universal';
2
3const response = await ky('https://example.com', {
4	// 20 MB
5	highWaterMark: 1000 * 1000 * 20
6});
7
8const data = await response.clone().buffer();

Related

• ky - Tiny and elegant HTTP client based on the browser Fetch API
• got - Simplified HTTP requests in Node.js