0.0.1 • Published 3 years ago

mobie-backdoor v0.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

MobileBackdoor 移动端后门调试程序

组件简介

本组件主用于解决移动端线上问题排查困难的痛点,通过用户的特殊操作(3 秒内连续点击屏幕 10 次或者长按屏幕 10 秒),调出 eruda 查看页面报错,进行问题排查

快速上手

  1. 安装
npm install
  1. 使用
import mobileBackdoor from 'mobile-backdoor'
const mobileBackdoor = new mobileBackdoor({})
mobileBackdoor.init()

例子

  • 只使用长按唤出
const mobileBackdoor = new MobileBackdoor({
    element: document.getElementById('testDiv') // 触发事件的element
    mode: 'touch', // 触发模式 click X秒内快速点击  touch 长按X秒  both: 快速点击和长按
    touchActiveTime: 1000, // 长按激活时间
    erudaConfig: {
        // eruda的配置,参考其官网
        useShadowDom: true,
    },
})
mobileBackdoor.init()
  • 使用自定义方法
const mobileBackdoor = new MobileBackdoor({
    element: document.getElementById('testDiv') // 触发事件的element
    mode: 'custom', // 触发模式 click X秒内快速点击  touch 长按X秒  both: 快速点击和长按 custom 自定义,需要配套传入 customFunction ,并且在该方法中调用callback回调
    customFunction:(callback)=>{
        console.log('调用了自定义方法')
            setTimeout(()=>{
            callback()
        },3000)
    }
    erudaConfig: {
        // eruda的配置,参考其官网
        useShadowDom: true,
    },
})
mobileBackdoor.init()

配置项

目前所有配置项均非必须,组件内部有设置兜底默认值,但是建议自行对某些值进行配置

名称说明类型默认值
element点击哪个元素触发后门调试程序HTML DOMhtml 标签,即点击整个页面时触发
mode后门触发的模式, click:X 秒内快速点击,touch:长按 X 秒, both: 快速点击和长按均可触发,custom: 外部自定义触发方法,需要配套传入 customFunction ,并且在该方法中调用 callback 函数单元格'both'
clickActiveTime快速点击唤起时间,mode 为 click 或者 both 时生效Number3000 (毫秒)
touchActiveTime长按屏幕唤起时间,mode 为 touch 或者 both 时生 e 效Number10000 (毫秒)
erudaConfigeruda 的配置,具体配置见 eruda 官网Object{ useShadowDom: true }
customFunction自定义唤起方法,mode 为 custom 时生效,使用该方法一定要调用 callback 函数,否则唤起不会生效数(callback) => void-

方法

名称说明
init初始化程序