English | 简体中文

local-mock-easy

A easy debug plugin for eruda and vConsole.

> local-mock full solution, reference local-mock-core

Note: local-mock-easy is only the client (H5) part of local-mock-core, complete local-mock debugging solution needs to install local-mock-middleware on the server (nodejs) at the same time, follow steps:

1. Install local-mock-middleware on the nodejs server.
1. Install local-mock-easy on the client.

Features

- 🎉without proxy, you do not need to map domain to local. (like: Charles Map Remote）
- 🚀devServer only, you do not need to start the node server at the same time.
- 🌻One-click debugging, through the local-mock-easy plugin, you can start debugging on the mobile machine with one click.
- 🌻Both static and gateway scenarios are supported, nodejs gateway proxy forwarding static resources and public network domain map to local static resources are both supported.

Get Started

$3

##### npm or yarn

``shell
npm i local-mock-easy
yarn add local-mock-easy
`

##### Using local-mock-easy from CDN

`html


`

$3

#### Plugin for eruda

`js
// #!if ENV === "development"
import eruda from 'eruda'
import { erudaLocalMock } from 'local-mock-easy'

eruda.init()

const localMockplugin = erudaLocalMock(eruda, {})

eruda.add(localMockplugin)
// #!endif
`

#### Plugin for vConsole

`js
// #!if ENV === "development"
import VConsole from 'vconsole'
import { vconsoleLocalMock } from 'local-mock-easy'

const vconsole = new VConsole()

const localMockplugin = vconsoleLocalMock(VConsole, {
key: 'myLocalMock',
state: 0,
entry: 'http://localhost:8080',
fast: 0,
// default agent mode, pleace install local-mock-middleware on nodejs gateway
mode: 'agent',
})

vconsole.addPlugin(localMockplugin)
// #!endif
`

$3

Since the entry file of 'devServer' is loaded in the domain name, you need to configure cross-origin and configure publicPath to load local static resources.

`json
{
"devServer": {
"publicPath": "http://localhost:8080",
"port": 8080,
"headers": {
"Access-Control-Allow-Origin": "*"
}
}
}
`

$3

- The cellular network needs to be on the same LAN as the localhost.
- publicPath and proxy change to http://{ip}:{port}, such as: http://192.168.1.10:8080

Options API

| params | desc | type | default |
| :-- | :-- | :-- | :-- |
| state | plugin open state | number | 0 |
| entry | the local entry | string | http://localhost:8080 |
| key | the query params name in url.
http://example.com?{key}={entry} | string | localMock |
| fast | whether to show fast button | number | 0 |
| mode | both static and gateway scenarios are supported | static or agent | agent` |

FQA

If you have any problems please contact us or open issues.

#### Why you need to change IP address？

Because the page resources of lcoalhost:8080 cannot be accessed on the mobile machine