@mswjs/interceptors 0.21.1 → 0.22.0

package/src/interceptors/ClientRequest/utils/getIncomingMessageBody.test.ts

@@ -1,9 +1,10 @@
+import { it, expect } from 'vitest'
 import { IncomingMessage } from 'http'
 import { Socket } from 'net'
 import * as zlib from 'zlib'
 import { getIncomingMessageBody } from './getIncomingMessageBody'
 
-test('returns utf8 string given a utf8 response body', async () => {
+it('returns utf8 string given a utf8 response body', async () => {
   const utfBuffer = Buffer.from('one')
   const message = new IncomingMessage(new Socket())
 
@@ -14,7 +15,7 @@ test('returns utf8 string given a utf8 response body', async () => {
   expect(await pendingResponseBody).toEqual('one')
 })
 
-test('returns utf8 string given a gzipped response body', async () => {
+it('returns utf8 string given a gzipped response body', async () => {
   const utfBuffer = zlib.gzipSync(Buffer.from('two'))
   const message = new IncomingMessage(new Socket())
   message.headers = {
@@ -28,7 +29,7 @@ test('returns utf8 string given a gzipped response body', async () => {
   expect(await pendingResponseBody).toEqual('two')
 })
 
-test('returns utf8 string given a gzipped response body with incorrect "content-lenght"', async () => {
+it('returns utf8 string given a gzipped response body with incorrect "content-lenght"', async () => {
   const utfBuffer = zlib.gzipSync(Buffer.from('three'))
   const message = new IncomingMessage(new Socket())
   message.headers = {
@@ -43,7 +44,7 @@ test('returns utf8 string given a gzipped response body with incorrect "content-
   expect(await pendingResponseBody).toEqual('three')
 })
 
-test('returns empty string given an empty body', async () => {
+it('returns empty string given an empty body', async () => {
   const message = new IncomingMessage(new Socket())
 
   const pendingResponseBody = getIncomingMessageBody(message)

package/src/interceptors/ClientRequest/utils/normalizeClientRequestArgs.test.ts

@@ -1,10 +1,11 @@
+import { it, expect } from 'vitest'
 import { parse } from 'url'
 import { globalAgent as httpGlobalAgent, RequestOptions } from 'http'
 import { Agent as HttpsAgent, globalAgent as httpsGlobalAgent } from 'https'
 import { getUrlByRequestOptions } from '../../../utils/getUrlByRequestOptions'
 import { normalizeClientRequestArgs } from './normalizeClientRequestArgs'
 
-test('handles [string, callback] input', () => {
+it('handles [string, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'https:',
     'https://mswjs.io/resource',
@@ -24,7 +25,7 @@ test('handles [string, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [string, RequestOptions, callback] input', () => {
+it('handles [string, RequestOptions, callback] input', () => {
   const initialOptions = {
     headers: {
       'Content-Type': 'text/plain',
@@ -47,7 +48,7 @@ test('handles [string, RequestOptions, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [URL, callback] input', () => {
+it('handles [URL, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'https:',
     new URL('https://mswjs.io/resource'),
@@ -67,7 +68,7 @@ test('handles [URL, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [Absolute Legacy URL, callback] input', () => {
+it('handles [Absolute Legacy URL, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'https:',
     parse('https://cherry:durian@mswjs.io:12345/resource?apple=banana'),
@@ -93,7 +94,7 @@ test('handles [Absolute Legacy URL, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [Relative Legacy URL, RequestOptions without path set, callback] input', () => {
+it('handles [Relative Legacy URL, RequestOptions without path set, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'http:',
     parse('/resource?apple=banana'),
@@ -115,7 +116,7 @@ test('handles [Relative Legacy URL, RequestOptions without path set, callback] i
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [Relative Legacy URL, RequestOptions with path set, callback] input', () => {
+it('handles [Relative Legacy URL, RequestOptions with path set, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'http:',
     parse('/resource?apple=banana'),
@@ -137,7 +138,7 @@ test('handles [Relative Legacy URL, RequestOptions with path set, callback] inpu
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [Relative Legacy URL, callback] input', () => {
+it('handles [Relative Legacy URL, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'http:',
     parse('/resource?apple=banana'),
@@ -157,7 +158,7 @@ test('handles [Relative Legacy URL, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [Relative Legacy URL] input', () => {
+it('handles [Relative Legacy URL] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'http:',
     parse('/resource?apple=banana')
@@ -176,7 +177,7 @@ test('handles [Relative Legacy URL] input', () => {
   expect(callback).toBeUndefined()
 })
 
-test('handles [URL, RequestOptions, callback] input', () => {
+it('handles [URL, RequestOptions, callback] input', () => {
   const [url, options, callback] = normalizeClientRequestArgs(
     'https:',
     new URL('https://mswjs.io/resource'),
@@ -211,7 +212,7 @@ test('handles [URL, RequestOptions, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [RequestOptions, callback] input', () => {
+it('handles [RequestOptions, callback] input', () => {
   const initialOptions = {
     method: 'POST',
     protocol: 'https:',
@@ -241,7 +242,7 @@ test('handles [RequestOptions, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('handles [Empty RequestOptions, callback] input', () => {
+it('handles [Empty RequestOptions, callback] input', () => {
   const [_, options, callback] = normalizeClientRequestArgs(
     'https:',
     {},
@@ -257,7 +258,7 @@ test('handles [Empty RequestOptions, callback] input', () => {
 /**
  * @see https://github.com/mswjs/interceptors/issues/19
  */
-test('handles [PartialRequestOptions, callback] input', () => {
+it('handles [PartialRequestOptions, callback] input', () => {
   const initialOptions = {
     method: 'GET',
     port: '50176',
@@ -291,7 +292,7 @@ test('handles [PartialRequestOptions, callback] input', () => {
   expect(callback?.name).toEqual('cb')
 })
 
-test('sets fallback Agent based on the URL protocol', () => {
+it('sets fallback Agent based on the URL protocol', () => {
   const [url, options] = normalizeClientRequestArgs(
     'https:',
     'https://github.com'
@@ -303,7 +304,7 @@ test('sets fallback Agent based on the URL protocol', () => {
   expect(agent).toHaveProperty('protocol', url.protocol)
 })
 
-test('does not set any fallback Agent given "agent: false" option', () => {
+it('does not set any fallback Agent given "agent: false" option', () => {
   const [, options] = normalizeClientRequestArgs(
     'https:',
     'https://github.com',
@@ -313,7 +314,7 @@ test('does not set any fallback Agent given "agent: false" option', () => {
   expect(options.agent).toEqual(false)
 })
 
-test('sets the default Agent for HTTP request', () => {
+it('sets the default Agent for HTTP request', () => {
   const [, options] = normalizeClientRequestArgs(
     'http:',
     'http://github.com',
@@ -323,7 +324,7 @@ test('sets the default Agent for HTTP request', () => {
   expect(options._defaultAgent).toEqual(httpGlobalAgent)
 })
 
-test('sets the default Agent for HTTPS request', () => {
+it('sets the default Agent for HTTPS request', () => {
   const [, options] = normalizeClientRequestArgs(
     'https:',
     'https://github.com',
@@ -333,7 +334,7 @@ test('sets the default Agent for HTTPS request', () => {
   expect(options._defaultAgent).toEqual(httpsGlobalAgent)
 })
 
-test('preserves a custom default Agent when set', () => {
+it('preserves a custom default Agent when set', () => {
   const [, options] = normalizeClientRequestArgs(
     'https:',
     'https://github.com',
@@ -348,7 +349,7 @@ test('preserves a custom default Agent when set', () => {
   expect(options._defaultAgent).toEqual(httpGlobalAgent)
 })
 
-test('merges URL-based RequestOptions with the custom RequestOptions', () => {
+it('merges URL-based RequestOptions with the custom RequestOptions', () => {
   const [url, options] = normalizeClientRequestArgs(
     'https:',
     'https://github.com/graphql',

package/src/interceptors/ClientRequest/utils/normalizeClientRequestEndArgs.test.ts

@@ -1,6 +1,7 @@
+import { it, expect } from 'vitest'
 import { normalizeClientRequestEndArgs } from './normalizeClientRequestEndArgs'
 
-test('returns [null, null, cb] given only the callback', () => {
+it('returns [null, null, cb] given only the callback', () => {
   const callback = () => {}
   expect(normalizeClientRequestEndArgs(callback)).toEqual([
     null,
@@ -9,11 +10,11 @@ test('returns [null, null, cb] given only the callback', () => {
   ])
 })
 
-test('returns [chunk, null, null] given only the chunk', () => {
+it('returns [chunk, null, null] given only the chunk', () => {
   expect(normalizeClientRequestEndArgs('chunk')).toEqual(['chunk', null, null])
 })
 
-test('returns [chunk, cb] given the chunk and the callback', () => {
+it('returns [chunk, cb] given the chunk and the callback', () => {
   const callback = () => {}
   expect(normalizeClientRequestEndArgs('chunk', callback)).toEqual([
     'chunk',
@@ -22,7 +23,7 @@ test('returns [chunk, cb] given the chunk and the callback', () => {
   ])
 })
 
-test('returns [chunk, encoding] given the chunk with the encoding', () => {
+it('returns [chunk, encoding] given the chunk with the encoding', () => {
   expect(normalizeClientRequestEndArgs('chunk', 'utf8')).toEqual([
     'chunk',
     'utf8',
@@ -30,7 +31,7 @@ test('returns [chunk, encoding] given the chunk with the encoding', () => {
   ])
 })
 
-test('returns [chunk, encoding, cb] given all three arguments', () => {
+it('returns [chunk, encoding, cb] given all three arguments', () => {
   const callback = () => {}
   expect(normalizeClientRequestEndArgs('chunk', 'utf8', callback)).toEqual([
     'chunk',

package/src/interceptors/ClientRequest/utils/normalizeClientRequestWriteArgs.test.ts

@@ -1,6 +1,7 @@
+import { it, expect } from 'vitest'
 import { normalizeClientRequestWriteArgs } from './normalizeClientRequestWriteArgs'
 
-test('returns a triplet of null given no chunk, encoding, or callback', () => {
+it('returns a triplet of null given no chunk, encoding, or callback', () => {
   expect(
     normalizeClientRequestWriteArgs([
       // @ts-ignore
@@ -11,7 +12,7 @@ test('returns a triplet of null given no chunk, encoding, or callback', () => {
   ).toEqual([undefined, undefined, undefined])
 })
 
-test('returns [chunk, null, null] given only a chunk', () => {
+it('returns [chunk, null, null] given only a chunk', () => {
   expect(normalizeClientRequestWriteArgs(['chunk', undefined])).toEqual([
     'chunk',
     undefined,
@@ -19,7 +20,7 @@ test('returns [chunk, null, null] given only a chunk', () => {
   ])
 })
 
-test('returns [chunk, encoding] given only chunk and encoding', () => {
+it('returns [chunk, encoding] given only chunk and encoding', () => {
   expect(normalizeClientRequestWriteArgs(['chunk', 'utf8'])).toEqual([
     'chunk',
     'utf8',
@@ -27,7 +28,7 @@ test('returns [chunk, encoding] given only chunk and encoding', () => {
   ])
 })
 
-test('returns [chunk, encoding, cb] given all three arguments', () => {
+it('returns [chunk, encoding, cb] given all three arguments', () => {
   const callbackFn = () => {}
   expect(
     normalizeClientRequestWriteArgs(['chunk', 'utf8', callbackFn])

package/src/interceptors/XMLHttpRequest/XMLHttpRequestController.ts

@@ -1,5 +1,4 @@
 import type { Debugger } from 'debug'
-import { Headers, Request } from '@remix-run/web-fetch'
 import { headersToString } from 'headers-polyfill'
 import { concatArrayBuffer } from './utils/concatArrayBuffer'
 import { createEvent } from './utils/createEvent'

package/src/interceptors/XMLHttpRequest/utils/concateArrayBuffer.test.ts

@@ -1,6 +1,4 @@
-/**
- * @jest-environment node
- */
+import { it, expect } from 'vitest'
 import { concatArrayBuffer } from './concatArrayBuffer'
 
 const encoder = new TextEncoder()

package/src/interceptors/XMLHttpRequest/utils/createEvent.test.ts

@@ -1,13 +1,12 @@
-/**
- * @jest-environment jsdom
- */
+// @vitest-environment jsdom
+import { it, expect } from 'vitest'
 import { createEvent } from './createEvent'
 import { EventPolyfill } from '../polyfills/EventPolyfill'
 
 const request = new XMLHttpRequest()
 request.open('POST', '/user')
 
-test('returns an EventPolyfill instance with the given target set', () => {
+it('returns an EventPolyfill instance with the given target set', () => {
   const event = createEvent(request, 'my-event')
   const target = event.target as XMLHttpRequest
 
@@ -15,7 +14,7 @@ test('returns an EventPolyfill instance with the given target set', () => {
   expect(target).toBeInstanceOf(XMLHttpRequest)
 })
 
-test('returns the ProgressEvent instance', () => {
+it('returns the ProgressEvent instance', () => {
   const event = createEvent(request, 'load', {
     loaded: 100,
     total: 500,

package/src/interceptors/XMLHttpRequest/utils/createResponse.ts

@@ -1,4 +1,3 @@
-import { Response } from '@remix-run/web-fetch'
 import { stringToHeaders } from 'headers-polyfill'
 
 export function createResponse(

package/src/interceptors/fetch/index.ts

@@ -1,5 +1,4 @@
 import { invariant } from 'outvariant'
-import type { Response as ResponsePolyfill } from '@remix-run/web-fetch'
 import { HttpRequestEventMap, IS_PATCHED_MODULE } from '../../glossary'
 import { Interceptor } from '../../Interceptor'
 import { uuidv4 } from '../../utils/uuid'
@@ -81,7 +80,7 @@ export class FetchInterceptor extends Interceptor<HttpRequestEventMap> {
       this.log('no mocked response received!')
 
       return pureFetch(request).then((response) => {
-        const responseClone = response.clone() as ResponsePolyfill
+        const responseClone = response.clone()
         this.log('original fetch performed', responseClone)
 
         this.emitter.emit(

package/src/utils/AsyncEventEmitter.test.ts

@@ -1,13 +1,14 @@
+import { vi, it, expect, afterEach } from 'vitest'
 import { AsyncEventEmitter } from './AsyncEventEmitter'
 import { sleep } from '../../test/helpers'
 
 afterEach(() => {
-  jest.useRealTimers()
+  vi.useRealTimers()
 })
 
 it('emits and listens to events', () => {
   const emitter = new AsyncEventEmitter<{ hello: [string] }>()
-  const listener = jest.fn()
+  const listener = vi.fn()
   emitter.on('hello', listener)
   emitter.emit('hello', 'John')
 
@@ -19,10 +20,10 @@ it('resolves "untilIdle" when all the event listeners are done', async () => {
   const emitter = new AsyncEventEmitter<{ speak: [string] }>()
 
   const results: string[] = []
-  const firstListener = jest.fn(() => results.push('first'))
+  const firstListener = vi.fn(() => results.push('first'))
   emitter.on('speak', firstListener)
 
-  const secondListener = jest.fn(async () => {
+  const secondListener = vi.fn(async () => {
     await sleep(150)
     results.push('second')
   })
@@ -43,7 +44,7 @@ it('resolves "untilIdle" only for the relevant listeners', async () => {
   const emitter = new AsyncEventEmitter<{ signal: [number] }>()
 
   const results: number[] = []
-  const listener = jest.fn(async (code: number) => {
+  const listener = vi.fn(async (code: number) => {
     if (code !== 1) {
       // Delay listener based on the signal code.
       await sleep(150)
@@ -79,7 +80,7 @@ it('propagates listener exceptions to "untilIdle" promise', async () => {
   const emitter = new AsyncEventEmitter<{ ping: never }>()
 
   const error = new Error('oops')
-  const listener = jest.fn(() => {
+  const listener = vi.fn(() => {
     throw error
   })
   emitter.on('ping', listener)
@@ -91,7 +92,7 @@ it('propagates listener exceptions to "untilIdle" promise', async () => {
 it('does not emit events once the emitter was deactivated', () => {
   const emitter = new AsyncEventEmitter<{ ping: never }>()
 
-  const listener = jest.fn()
+  const listener = vi.fn()
   emitter.on('ping', listener)
   emitter.deactivate()
 

package/src/utils/bufferUtils.test.ts

@@ -1,3 +1,4 @@
+import { it, expect } from 'vitest'
 import { decodeBuffer, encodeBuffer } from './bufferUtils'
 
 it('encodes utf-8 string', () => {

package/src/utils/cloneObject.test.ts

@@ -1,6 +1,7 @@
+import { it, expect } from 'vitest'
 import { cloneObject } from './cloneObject'
 
-test('clones a shallow object', () => {
+it('clones a shallow object', () => {
   const original = { a: 1, b: 2, c: [1, 2, 3] }
   const clone = cloneObject(original)
 
@@ -18,7 +19,7 @@ test('clones a shallow object', () => {
   expect(original).toHaveProperty('c', [1, 2, 3])
 })
 
-test('clones a nested object', () => {
+it('clones a nested object', () => {
   const original = { a: { b: 1 }, c: { d: { e: 2 } } }
   const clone = cloneObject(original)
 
@@ -33,7 +34,7 @@ test('clones a nested object', () => {
   expect(original).toHaveProperty(['c', 'd', 'e'], 2)
 })
 
-test('clones a class instance', () => {
+it('clones a class instance', () => {
   class Car {
     public manufacturer: string
     constructor() {
@@ -53,7 +54,7 @@ test('clones a class instance', () => {
   expect(clone.getManufacturer()).toEqual('Audi')
 })
 
-test('ignores nested class instances', () => {
+it('ignores nested class instances', () => {
   class Car {
     name: string
     constructor(name: string) {
@@ -81,7 +82,7 @@ test('ignores nested class instances', () => {
   expect(original.car.getName()).toEqual('Audi')
 })
 
-test('clones an object with null prototype', () => {
+it('clones an object with null prototype', () => {
   const original = {
     key: Object.create(null),
   }

package/src/utils/getCleanUrl.test.ts

@@ -1,29 +1,30 @@
+import { describe, it, expect } from 'vitest'
 import { getCleanUrl } from './getCleanUrl'
 
 describe('getCleanUrl', () => {
   describe('given a URL without query parameters', () => {
-    test('should return url href as-is', () => {
+    it('should return url href as-is', () => {
       const url = new URL('https://github.com')
       expect(getCleanUrl(url)).toEqual('https://github.com/')
     })
   })
 
   describe('given a URL with query parameters', () => {
-    test('should return url without parameters', () => {
+    it('should return url without parameters', () => {
       const url = new URL('https://github.com/mswjs/?userId=abc-123')
       expect(getCleanUrl(url)).toEqual('https://github.com/mswjs/')
     })
   })
 
   describe('given a URL with a hash', () => {
-    test('should return a url without hash', () => {
+    it('should return a url without hash', () => {
       const url = new URL('https://github.com/mswjs/#hello-world')
       expect(getCleanUrl(url)).toEqual('https://github.com/mswjs/')
     })
   })
 
   describe('given an absolute URL ', () => {
-    test('should return a clean relative URL', () => {
+    it('should return a clean relative URL', () => {
       const url = new URL('/login?query=value', 'https://github.com')
       expect(getCleanUrl(url, false)).toEqual('/login')
     })

package/src/utils/getUrlByRequestOptions.test.ts

@@ -1,8 +1,9 @@
+import { it, expect } from 'vitest'
 import { Agent as HttpAgent } from 'http'
 import { RequestOptions, Agent as HttpsAgent } from 'https'
 import { getUrlByRequestOptions } from './getUrlByRequestOptions'
 
-test('returns a URL based on the basic RequestOptions', () => {
+it('returns a URL based on the basic RequestOptions', () => {
   const options: RequestOptions = {
     protocol: 'https:',
     host: '127.0.0.1',
@@ -15,7 +16,7 @@ test('returns a URL based on the basic RequestOptions', () => {
   expect(url).toHaveProperty('href', 'https://127.0.0.1/resource')
 })
 
-test('inherits protocol and port from http.Agent, if set', () => {
+it('inherits protocol and port from http.Agent, if set', () => {
   const options: RequestOptions = {
     host: '127.0.0.1',
     path: '/',
@@ -29,7 +30,7 @@ test('inherits protocol and port from http.Agent, if set', () => {
   expect(url).toHaveProperty('href', 'http://127.0.0.1/')
 })
 
-test('inherits protocol and port from https.Agent, if set', () => {
+it('inherits protocol and port from https.Agent, if set', () => {
   const options: RequestOptions = {
     host: '127.0.0.1',
     path: '/',
@@ -45,7 +46,7 @@ test('inherits protocol and port from https.Agent, if set', () => {
   expect(url).toHaveProperty('href', 'https://127.0.0.1:3080/')
 })
 
-test('resolves protocol to "http" given no explicit protocol and no certificate', () => {
+it('resolves protocol to "http" given no explicit protocol and no certificate', () => {
   const options: RequestOptions = {
     host: '127.0.0.1',
     path: '/',
@@ -58,7 +59,7 @@ test('resolves protocol to "http" given no explicit protocol and no certificate'
   expect(url).toHaveProperty('href', 'http://127.0.0.1/')
 })
 
-test('resolves protocol to "https" given no explicit protocol, but certificate', () => {
+it('resolves protocol to "https" given no explicit protocol, but certificate', () => {
   const options: RequestOptions = {
     host: '127.0.0.1',
     path: '/secure',
@@ -72,7 +73,7 @@ test('resolves protocol to "https" given no explicit protocol, but certificate',
   expect(url).toHaveProperty('href', 'https://127.0.0.1/secure')
 })
 
-test('resolves protocol to "https" given no explicit protocol, but port is 443', () => {
+it('resolves protocol to "https" given no explicit protocol, but port is 443', () => {
   const options: RequestOptions = {
     host: '127.0.0.1',
     port: 443,
@@ -85,7 +86,7 @@ test('resolves protocol to "https" given no explicit protocol, but port is 443',
   expect(url).toHaveProperty('href', 'https://127.0.0.1/resource')
 })
 
-test('resolves protocol to "https" given no explicit protocol, but agent port is 443', () => {
+it('resolves protocol to "https" given no explicit protocol, but agent port is 443', () => {
   const options: RequestOptions = {
     host: '127.0.0.1',
     agent: new HttpsAgent({
@@ -100,7 +101,7 @@ test('resolves protocol to "https" given no explicit protocol, but agent port is
   expect(url).toHaveProperty('href', 'https://127.0.0.1/resource')
 })
 
-test('inherits "port" if given', () => {
+it('inherits "port" if given', () => {
   const options = {
     protocol: 'http:',
     host: '127.0.0.1',
@@ -115,7 +116,7 @@ test('inherits "port" if given', () => {
   expect(url).toHaveProperty('href', 'http://127.0.0.1:4002/')
 })
 
-test('inherits "username" and "password"', () => {
+it('inherits "username" and "password"', () => {
   const options: RequestOptions = {
     protocol: 'https:',
     host: '127.0.0.1',
@@ -131,7 +132,7 @@ test('inherits "username" and "password"', () => {
   expect(url).toHaveProperty('href', 'https://admin:abc-123@127.0.0.1/user')
 })
 
-test('resolves hostname to localhost if none provided', () => {
+it('resolves hostname to localhost if none provided', () => {
   const url = getUrlByRequestOptions({})
 
   expect(url).toBeInstanceOf(URL)

package/src/utils/getUrlByRequestOptions.ts

@@ -68,6 +68,15 @@ function getAuthByRequestOptions(options: ResolvedRequestOptions) {
   }
 }
 
+/**
+ * Returns true if host looks like an IPv6 address without surrounding brackets
+ * It assumes any host containing `:` is definitely not IPv4 and probably IPv6,
+ * but note that this could include invalid IPv6 addresses as well.
+ */
+function isRawIPv6Address(host: string): boolean {
+  return host.includes(':') && !host.startsWith('[') && !host.endsWith(']')
+}
+
 /**
  * Creates a `URL` instance from a given `RequestOptions` object.
  */
@@ -85,7 +94,11 @@ export function getUrlByRequestOptions(options: ResolvedRequestOptions): URL {
   debug('port', port)
   debug('path', path)
 
-  const baseUrl = `${protocol}//${host}`
+  /**
+   * @note As of Node >= 17, hosts (including "localhost") can resolve to IPv6
+   * addresses, so construct valid URL by surrounding the IPv6 host with brackets.
+   */
+  const baseUrl = `${protocol}//${isRawIPv6Address(host) ? `[${host}]` : host}`
   debug('base URL:', baseUrl)
 
   const url = options.uri ? new URL(options.uri.href) : new URL(path, baseUrl)

package/src/utils/isObject.test.ts

@@ -1,16 +1,17 @@
+import { it, expect } from 'vitest'
 import { isObject } from './isObject'
 
-test('resolves given an object', () => {
+it('resolves given an object', () => {
   expect(isObject({})).toBe(true)
   expect(isObject({ a: 1 })).toBe(true)
 })
 
-test('rejects given an object-like instance', () => {
+it('rejects given an object-like instance', () => {
   expect(isObject([1])).toBe(false)
   expect(isObject(function () {})).toBe(false)
 })
 
-test('rejects given a non-object instance', () => {
+it('rejects given a non-object instance', () => {
   expect(isObject(null)).toBe(false)
   expect(isObject(undefined)).toBe(false)
   expect(isObject(false)).toBe(false)

package/src/utils/parseJson.test.ts

@@ -1,9 +1,10 @@
+import { it, expect } from 'vitest'
 import { parseJson } from './parseJson'
 
-test('parses a given string into JSON', () => {
+it('parses a given string into JSON', () => {
   expect(parseJson('{"id":1}')).toEqual({ id: 1 })
 })
 
-test('returns null given invalid JSON string', () => {
+it('returns null given invalid JSON string', () => {
   expect(parseJson('{"o:2\'')).toBeNull()
 })