gotlike v0.2.0

Gotlike

Barebones got-like undici-based not-as-safe commonjs-compatible http client for node.js.

Includes a basic nock-like mocking system (since nock doesn't work with undici).

The idea is to be able to replace got and nock with gotlike in most cases, while being more performant. At the moment only the features I use are implemented.

Supports:

• Extendable client
• Handlers
• Hooks (single function per hook)
• Retries (partial support - uses undici's RetryAgent)
• Streams (no progress or timings)
• Timings (only total request)
• Response body in json parse error
• Nock-like mocking
• DNS Cache
• HTTP2
• Pipelining
• Options validation

Differences

• retry, http2, pipelining, dnsCache, dnsLookup and agent can be set only on instance create/extend

Benchmark

got - promise x 9,576 ops/sec ±1.27% (82 runs sampled)
got - stream x 10,456 ops/sec ±3.78% (82 runs sampled)
request - callback x 11,671 ops/sec ±0.86% (84 runs sampled)
node-fetch - promise x 10,472 ops/sec ±2.86% (81 runs sampled)
axios - promise x 10,443 ops/sec ±2.70% (81 runs sampled)
native fetch - promise x 16,702 ops/sec ±2.53% (81 runs sampled)
gotlike - promise x 23,230 ops/sec ±0.66% (85 runs sampled)

Fastest is gotlike - promise

Usage

import { Gotlike } from 'gotlike'

// these work as well
// const {gotlike} = require('gotlike')
// const {got} = require('gotlike')
// import got from 'gotlike'
// import {Got} from 'gotlike'
// import {gotlike} from 'gotlike'

const gotlike = new Gotlike({ // or gotlike.extend({ ... })
  prefixUrl: 'https://example.com/api/v1',
  headers: {
    'authorization': 'Basic test:test',
  },
  responseType: 'json',
})

const response = await gotlike.get('/test')

console.log(response.body)