Registry / http-networking / vite-plugin-fake-server-turbo

vite-plugin-fake-server-turbo

library3.0.18jsnpmunverified

A fake server plugin for Vite that intercepts HTTP requests (XHR and Fetch) to return mock data during development or production. Version 3.0.18, actively maintained with frequent releases (last update ~1 month ago). Supports ESM/CJS, TypeScript type hints via defineFakeRoute, multiple file types (ts, js, mjs, cjs, mts, cts), and both HTTP/1 and HTTP/2. No built-in mock library dependency – works with @faker-js/faker, mockjs, or custom responses. Features include custom response headers/status, timeout simulation, raw response handling, and production build export. Interception is powered by XHook, which has known Firefox issues (see warnings).

http-networking web-framework testing

npm install vite-plugin-fake-server-turbo

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-FAKE-S

vite-plugin-fake-server-turbo

http-networkingjavascriptv3.0.18

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

vitePluginFakeServer

✓ import { vitePluginFakeServer } from 'vite-plugin-fake-server'

✗ import vitePluginFakeServer from 'vite-plugin-fake-server'

Named export only; default import will fail (ESM).

defineFakeRoute

✓ import { defineFakeRoute } from 'vite-plugin-fake-server/client'

✗ import { defineFakeRoute } from 'vite-plugin-fake-server'

defineFakeRoute is exported from /client subpath, not the main entry. Using the wrong import path will result in undefined.

FakeRoute

✓ import type { FakeRoute } from 'vite-plugin-fake-server/client'

✗ import { FakeRoute } from 'vite-plugin-fake-server'

FakeRoute is a type exported from /client. Use type import for TypeScript to avoid runtime errors.

Sets up vite-plugin-fake-server with a Vite config, defines a fake route for /mock/get-user-info, and intercepts the request at runtime.

// vite.config.ts import { defineConfig } from 'vite'; import { vitePluginFakeServer } from 'vite-plugin-fake-server'; export default defineConfig({ plugins: [vitePluginFakeServer()], }); // fake/user.fake.ts import { defineFakeRoute } from 'vite-plugin-fake-server/client'; export default defineFakeRoute([ { url: '/mock/get-user-info', response: () => ({ id: '123', name: 'John' }), }, ]); // Then fetch('/mock/get-user-info') in your app; the fake server intercepts and returns the mock response.

Debug

Known issues

gotchaimport { defineFakeRoute } from 'vite-plugin-fake-server' does not work – must import from 'vite-plugin-fake-server/client'

fix

Use import { defineFakeRoute } from 'vite-plugin-fake-server/client'

affects: >=2.0.0

breakingv2.2.1: XHook cannot carry a payload in Firefox (https://github.com/jpillora/xhook/issues/183) – affecting Fetch requests

fix

Upgrade to v2.2.2+ which includes a workaround for Firefox XHR payload issue

affects: >=2.2.1 <2.2.2

gotchaInterception only works in browser – not during SSR or Node.js environments

fix

Do not use this plugin for server-side mock data; rely on standard mocking libraries like vitest-fetch-mock for Node tests

affects: all

deprecatedv2.1.4 replaced fast-glob with tinyglobby; any custom glob patterns from fast-glob may not work

fix

Ensure your glob patterns are compatible with tinyglobby (e.g., {**/*.fake.ts} works, but some fast-glob extensions might fail)

affects: >=2.1.4

Errors

Common errors & fixes

TypeError: vitePluginFakeServer is not a function

Default import used instead of named import (e.g., import vitePluginFakeServer from 'vite-plugin-fake-server')

fix

Use named import: import { vitePluginFakeServer } from 'vite-plugin-fake-server'

ReferenceError: defineFakeRoute is not defined

Import from wrong path (e.g., import { defineFakeRoute } from 'vite-plugin-fake-server')

fix

Import from 'vite-plugin-fake-server/client' instead

SyntaxError: Cannot use import statement outside a module (in fake file)

The plugin's fake file uses ESM `export default` but the project is configured as CommonJS or the file extension is .js without type: module

fix

Rename to .mjs or .mts, or set "type": "module" in package.json, or use CommonJS syntax (module.exports) in .cjs files

Upgrade

Version history

3.0.18latest on npm

Audit

Dependencies

viterequiredpeer dependency – required Vite project to function as a plugin

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/condorheroblog/vite-plugin-fake-server ↗

packagehttps://www.npmjs.com/package/vite-plugin-fake-server-turbo ↗