English | 中文
Provide local and prod mocks for vite.
A mock plugin for vite, developed based on mockjs. And support the local environment and production environment at the same time. Connect service middleware is used locally, mockjs is used online
node version: >=12.0.0
vite version: >=2.0.0
yarn add mockjs # or npm i mockjs -S # or pnpm add mockjs
and
yarn add vite-plugin-mock -D # or npm i vite-plugin-mock -D # or pnpm add vite-plugin-mock -D
Run Example
# ts example cd ./examples/ts-examples yarn install yarn serve # js example cd ./examples/js-examples yarn install yarn serve
Development environment
The development environment is implemented using Connect middleware。
Different from the production environment, you can view the network request record in the Google Chrome console
import { UserConfigExport, ConfigEnv } from 'vite' import { viteMockServe } from 'vite-plugin-mock' import vue from '@vitejs/plugin-vue' export default ({ command }: ConfigEnv): UserConfigExport => { return { plugins: [ vue(), viteMockServe({ // default mockPath: 'mock', enable: true, }), ], } }
{ mockPath?: string; ignore?: RegExp | ((fileName: string) => boolean); watchFiles?: boolean; enable?: boolean; ignoreFiles?: string[]; configPath?: string; }
type: string
default: 'mock'
Set the folder where the mock .ts file is stored
If watchFiles:true
, the file changes in the folder will be monitored. And synchronize to the request result in real time
If configPath has a value, it is invalid
type: RegExp | ((fileName: string) => boolean);
default: undefined
When automatically reading analog .ts files, ignore files in the specified format
type: boolean
default: true
Set whether to monitor changes in mock .ts files
type: boolean
default: true
Whether to enable the mock function
type: string
default: vite.mock.config.ts
Set the data entry that the mock reads. When the file exists and is located in the project root directory, the file will be read and used first. The configuration file returns an array
type: boolean
default: true
Whether to display the request log on the console
/path/mock
// test.ts import { MockMethod, MockConfig } from 'vite-plugin-mock' export default [ { url: '/api/get', method: 'get', response: ({ query }) => { return { code: 0, data: { name: 'vben', }, } }, }, { url: '/api/post', method: 'post', timeout: 2000, response: { code: 0, data: { name: 'vben', }, }, }, { url: '/api/text', method: 'post', rawResponse: async (req, res) => { let reqbody = '' await new Promise((resolve) => { req.on('data', (chunk) => { reqbody += chunk }) req.on('end', () => resolve(undefined)) }) res.setHeader('Content-Type', 'text/plain') res.statusCode = 200 res.end(`hello, ${reqbody}`) }, }, ] as MockMethod[] export default function (config: MockConfig) { return [ { url: '/api/text', method: 'post', rawResponse: async (req, res) => { let reqbody = '' await new Promise((resolve) => { req.on('data', (chunk) => { reqbody += chunk }) req.on('end', () => resolve(undefined)) }) res.setHeader('Content-Type', 'text/plain') res.statusCode = 200 res.end(`hello, ${reqbody}`) }, }, ] }
{ // request url url: string; // request method method?: MethodType; // Request time in milliseconds timeout?: number; // default: 200 statusCode?:number; // response data (JSON) response?: ((opt: { [key: string]: string; body: Record<string,any>; query: Record<string,any>, headers: Record<string, any>; }) => any) | any; // response (non-JSON) rawResponse?: (req: IncomingMessage, res: ServerResponse) => void; }Example (3.0.0 recommended)
Create the mockProdServer.ts
file
// mockProdServer.ts import { createProdMockServer } from 'vite-plugin-mock/client' // Import your mock .ts files one by one // If you use vite.mock.config.ts, just import the file directly // You can use the import.meta.glob function to import all import testModule from '../mock/test' export function setupProdMockServer() { createProdMockServer([...testModule]) }
Config vite-plugin-mock
import { viteMockServe } from 'vite-plugin-mock' import { UserConfigExport, ConfigEnv } from 'vite' export default ({ command }: ConfigEnv): UserConfigExport => { return { plugins: [ viteMockServe({ mockPath: 'mock', // According to the project configuration. Can be configured in the .env file enable: true, }), ], } }
MIT
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4