1
0
mirror of synced 2025-12-08 14:54:02 +08:00
Files
eruda/doc/README_CN.md
2019-06-19 11:54:53 +08:00

5.1 KiB
Raw Blame History

Eruda

Join the chat at https://gitter.im/liriliri/eruda NPM version Build status Test coverage License

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

Demo

Demo

请扫描二维码或在手机上直接访问:https://eruda.liriliri.io/

如果想在其它页面尝试,请在浏览器地址栏上输入以下代码。

javascript:(function () { var script = document.createElement('script'); script.src="//cdn.jsdelivr.net/npm/eruda"; document.body.appendChild(script); script.onload = function () { eruda.init() } })();

功能清单

Eruda

  1. 按钮拖拽,面板透明度大小设置。

  2. Console面板捕获Console日志支持log、error、info、warn、dir、time/timeEnd、clear、count、assert、table支持占位符包括%c自定义样式输出支持按日志类型及正则表达式过滤支持快捷命令加载underscore、jQuery库支持JavaScript脚本执行。

  3. Elements面板查看标签内容及属性查看应用在Dom上的样式支持页面元素高亮支持屏幕直接点击选取查看Dom上绑定的各类事件。

  4. Network面板捕获请求查看发送数据、返回头、返回内容等信息。

  5. Resources面板查看并清除localStorage、sessionStorage及cookie查看页面加载脚本及样式文件查看页面加载图片。

  6. Sources面板查看页面源码格式化htmlcssjs代码及json数据。

  7. Info面板输出URL及User Agent支持自定义输出内容。

  8. Snippets面板页面元素添加边框加时间戳刷新页面支持自定义代码片段。

快速上手

通过CDN使用

<script src="//cdn.bootcss.com/eruda/1.5.2/eruda.min.js"></script>
<script>eruda.init();</script>

通过npm安装

npm install eruda --save

在页面中加载脚本:

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

Js文件对于移动端来说略重gzip后大概100kb。建议通过url参数来控制是否加载调试器比如

;(function () {
    var src = 'node_modules/eruda/eruda.min.js';
    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 编写插件来增强功能。关于怎么编写插件,请查看下边官方插件的源码。另外 eruda-plugin 可以用来初始化一个新插件。

编写插件的时候,你可以使用 Eruda 提供的工具函数,相关文档请点击这里查看。

相关项目