Eruda-移动端网页调试工具

无意间发现一个很棒的工具Eruda,我们可以通过它实现在移动端调试网页。

关于Eruda

Eruda 是一个专为手机网页前端设计的调试面板,类似 DevTools 的迷你版,其主要功能包括:捕获 console 日志、检查元素状态、捕获XHR请求、显示本地存储和 Cookie 信息等等。

使用展示


在手机上调试网页

功能清单

  1. 按钮拖拽,面板透明度大小设置。
  2. Console 面板:捕获 Console 日志,支持 log、error、info、warn、dir、time/timeEnd、clear、count、assert、table;支持占位符,包括 %c 自定义样式输出;支持按日志类型及正则表达式过滤;支持 JavaScript 脚本执行。
  3. Elements 面板:查看标签内容及属性;查看应用在 Dom 上的样式;支持页面元素高亮;支持屏幕直接点击选取;查看 Dom 上绑定的各类事件。
  4. Network 面板:捕获请求,查看发送数据、返回头、返回内容等信息。
  5. Resources 面板:查看并清除 localStorage、sessionStorage 及 cookie;查看页面加载脚本及样式文件;查看页面加载图片。
  6. Sources 面板:查看页面源码;格式化 html,css,js 代码及 json 数据。
  7. Info 面板:输出 URL 及 User Agent;支持自定义输出内容。
  8. Snippets 面板:页面元素添加边框;加时间戳刷新页面;支持自定义代码片段。

使用方法

通过CDN使用:

<script src="//cdn.jsdelivr.net/npm/eruda"></script>
<script>eruda.init();</script>

通过 npm 安装:

npm install eruda --save

在页面中加载脚本:

<script src="node_modules/eruda/eruda.js"></script>
<script>eruda.init();</script>

JS 文件对于移动端来说略重(gzip 后大概 100kb)。可以通过 url 参数来控制是否加载调试器,比如:

;(function () {
    var src = '//cdn.jsdelivr.net/npm/eruda';
    if (!/eruda=true/.test(window.location) && localStorage.getItem('active-eruda') != 'true') return;
    document.write('<scr' + 'ipt src="' + src + '"></scr' + 'ipt>');
    document.write('<scr' + 'ipt>eruda.init();</scr' + 'ipt>');
})();

初始化时可以传入配置:

  • container: 用于插件初始化的 Dom 元素,如果不设置,默认创建 div 作为容器直接置于 html 根结点下面。
  • tool:指定要初始化哪些面板,默认加载所有。
let el = document.createElement('div');
document.body.appendChild(el);
eruda.init({
    container: el,
    tool: ['console', 'elements'],
    useShadowDom: true
});

Eruda插件

Api

初始化Eruda

配置项

名称 类型 描述
container element 容器元素。如果未设置,它将直接在html根元素下附加一个元素
tool string array 选择所需的工具,默认情况下将全部添加
autoScale=true boolean 针对不同窗口设置自动缩放eruda
useShadowDom=true boolean 使用Shadow dom进行CSS封装

eg:

let el = document.createElement('div');
document.body.appendChild(el);
eruda.init({
    container: el,
    tool: ['console', 'elements'],
    useShadowDom: true,
    autoScale: true
});

销毁Eruda

注意:销毁后可以再次调用init方法。

eruda.destroy();

设置或获取比例

eruda.scale(); // -> 1
eruda.scale(1.5);

设置或获取输入按钮的位置。

eruda.position({x: 20, y: 20});
eruda.position(); // -> {x: 20, y: 20}

工具设置

// 添加工具
eruda.add(new (eruda.Tool.extend({
    name: 'test'
})));
//移除工具
eruda.remove('console');

调试面板

// 显示面板
eruda.show();
eruda.show('console');
//隐藏面板
eruda.hide();

项目地址

项目地址:https://github.com/liriliri/eruda

© 版权声明
THE END
喜欢就支持以下吧
点赞0赞赏
分享
评论 抢沙发

请登录后发表评论