#web-debug

一个用于辅助前端开发的轻量级调试工具。支持自动刷新及远程调试。

功能：

本工具会在页面被请求时动态插入livereload及weinre调试标签，同时在自动在后台开启文件watch及weinre后台服务。

• 支持livereload
• 支持在当前页面生成二维码（ctrl+shift+z）
• 支持weinre调试（先前版本采用debuggap, 现弃用）
• 支持动态数据mock, 此功能由tiny-http提供。
• 实现类fiddler,chales全局代理，开启此模式可以在手机端调试任意页面。

特点：

支持静态服务器模式及代理模式。可以自动在任意页面注入script

安装：

npm install -g web-debug

使用：

> web-debug -r ./htdocs -p 8080 --autostart
;开启服务器模式

> web-debug -r ./htdocs -p 7777 --proxy
;开启全局代理模式，可以调式任意页面

参数说明：

-r, --root 静态服务器模式下为web根目录，代理模式下为watch目录
-p, --port 静态服务器模式下为web启动端口，代理模式下为代理监听端口
-A, --autostart 自动打开浏览器
-P, --proxy     启用代理模式，默认为静态服务器模式
-w, --weinre    启用weinre，默认使用debuggap

ctrl+shift+z可以显示二维码，方便手机应用（如微信）打开页面

局限性：

局限性主要针对代理模式：

• 为了保证代理速度，目前只支持uff-8编码的页面，代理gbk页面时会出现乱码
• 代理会直接放行https请求，所以暂不支持https页面标签动态注入

功能增强计划：

• [ ] 增加对gbk编码的支持
• [ ] 增加对自定义script的实时注入（目前仅支持livereload.js(实时刷新),qrcode.js(二维码),target.js(远程调试)）
• [ ] 支持https

Dependencies:

• chokidar: ^1.3.0
• livereload-server-spec: 0.2.3
• portfinder: 0.4.0
• tiny-http: >=2.0.0
• weinre: *