whistle | HTTP , HTTP2 , HTTPS , Websocket debugging proxy | Runtime Evironment library

The latest LTS version of Node.js is recommended. If none or low version of Node.js is installed, you need install the latest version of Node.js according to the following instructions：. You can execute node -v in shell to check if the expected version of Node.js is installed successfully：. After the Node.js is installed successfully, you can execute the following npm command to install whistle（In Mac or Linux, prefix sudo is needed if you are not root user, i.e. sudo npm install -g whistle）. In China, you can install whistle using npm mirror of taobao to speed up installing progress and avoid failure：.
For Windows: please visit https://nodejs.org/ to download the latest LTS version of Node.js and then, install it using the default options.
For Mac: the same as Windows.
For Linux: using source code to install is recommended, because in this way, you don't need to configure the path.  If you fail to install with source code, you can also use the binary version of Node.js directly. with source package： visit Official website of Node to download the latest version of Source Code*(or using wget in shell), unzip(tar -xzvf node-xxx.tar.gz), switch to the root directory(cd node-xxx), execute ./configure, ./make and ./make install in order。 using binary version：visit Official website of Node to download the latest Linux Binaries(or using command wget to download), unzip(tar -xzvf node-xxx.tar.gz), add the absolute path of bin directory to system PATH after extracting。
Open Rules tab in whistle, and create a group named test by context menu or Create button in menu bar. Then follow the next steps to write rules and save. Replace the response with content in local file system, which is frequently used during web developing. http://www.ifeng.com/ will try to load /User/username/test first. If the former dosen't exist, the file /User/username/test/index.html will be loaded. For neither exists, it returns 404. To replace jsonp request, you can refer to tpl. For more details, please vsit Pattern Matching.
cofigure hosts Specify the ip of www.ifeng.com: www.ifeng.com 127.0.0.1 # or 127.0.0.1 www.ifeng.com Specify the ip and port of www.ifeng.com to forward http request to local port 8080. In this way, we can visit the local website just as online when the developing port is not 80: # www.ifeng.com 127.0.0.1 www.ifeng.com 127.0.0.1:8080 # or 127.0.0.1:8080 www.ifeng.com We can also replace the real IP (or domain) and port with any domain without port: www.ifeng.com host://www.qq.com:8080 # or host://www.qq.com:8080 www.ifeng.com For more details, please visit Pattern Matching
local files replacing
Request Forward To forward all the requests from domain www.ifeng.com to domain www.aliexpress.com www.ifeng.com www.aliexpress.com For more details, Pattern Matching
Inject html、js、css whistle will decide whether injecting corresponding text and how to inject, like whether wrapping the text with HTML label, automatically according to response type. # Mac、Linux www.ifeng.com html:///User/xxx/test/test.html www.ifeng.com js:///User/xxx/test/test.js www.ifeng.com css:///User/xxx/test/test.css # Both '\' and '/' can be used as path separator for Widows www.ifeng.com html://E:\xx\test\test.html www.ifeng.com js://E:\xx\test\test.js www.ifeng.com css://E:\xx\test\test.css For all the requests for domain www.ifeng.com, whistle will inject the processed text to response body according to response type. If the type is HTML, the js content will be wrapped within script, and the css content be wrapped within style to be injected to response body。 For more details, Pattern Matching
Debug for remote page With the protocol weinre and protocol log provided by whistle, you can modify the DOM structure, capture the javascript errors and view the console print easily. Moreover, you can inject specified script to debug the remote page. Before using whistle to debug remote page, you need to set the proxy for OS or browser to whistle. Please refers Install and start to know how to set the proxy. For weinre： www.ifeng.com weinre://test Add the following rule in group named test and save, open the www.ifeng.com with a new tab in browser. Then you can see a list when you hover over the button weinre, click the item test to open a weinre debug page. For example, you can see the DOM structure when swich to Elements tab after selected a target. For log: www.ifeng.com log://{test.js} Add the following rule in group named test and save. Then you can see a list when you hover over the button Values, whistle will create a group named test.js in Values when you click it. Input the text console.log(1, 2, 3, {a: 123}) in the group editor, open the Network -> Log -> Console, open the www.ifeng.com, you can see the output '1, 2, 3, {a: 123}' in Console panel. For more details, Pattern Matching and Rules