sdenv-extend v1.3.1

用于sdenv补环境框架与真实浏览器加载网页的公共方法与共有处理.

node端

1. 安装包：npm install sdenv-extend
2. 导入：const SdenvExtend = require('sdenv-extend')
3. 初始化(需要传入window对象)：window.sdenv = new SdenvExtend({ }, window)

浏览器端

打包文件下载：https://github.com/pysunday/sdenv-extend/releases，文件名为sdenv-extend-iife的js文件即为浏览器端使用文件。

1. head内引入：<script type="text/javascript" charset="utf-8" src="/path/to/sdenv-extend-iife.js"></script>
2. 初始化：window.sdenv = new SdenvExtend(cfg)
3. html页面中使用：

if (!window.sdenv) window.sdenv = new SdenvExtend();

4. 使用extend handle拓展方法，应该在网页第一处javascript执行前后添加，即执行html中javascript代码前的最后一处node执行处或者就在该javascript代码内，建议是在html中的第一处javascript代码内使用，如：

sdenv
  .getHandle('battery')('charging_success')
  .getHandle('eval')()
  ...
  .getHandle('func')();

API

extend handle拓展方法

在SdenvExtend实例化对象后通过链式方法getHandle添加，见上方浏览器端第四条

.getHandle('battery')(string | object)

作用: 定义机器电量及充电状态，跳转MDN文档

params:

• string(预存配置)：charging_success(正在充电，电量100%，该项默认)、discharging_success(未充电，电量100%)、charging_ing(正在充电)、discharging_ing(未充电)
• object(自定义配置)：如预存配置不满足使用需求则可传入自定义对象，参考浏览器端navigator.getBattery().then(data => console.log(data))打印结果

默认值：

{
  onchargingchange: null,
  onchargingtimechange: null,
  ondischargingtimechange: null,
  onlevelchange: null,
  charging: true,
  chargingTime: 0,
  dischargingTime: Infinity,
  level: 1,
}

.getHandle('connection')(object)

作用：定义网络环境，跳转MDN文档

params:

• object：参考浏览器端navigator.connection返回结果

默认值：

{
  downlink: 6.66,
  effectiveType: "4g",
  onchange: null,
  rtt: 0,
  saveData: false,
}

.getHandle('cookie')(object)

作用：cookie值监控封装，跳转MDN文档

params:

• object: 包含日志打印、回调、数据处理的钩子对象，可用属性(参考附录一)：getLog、setLog、log、getCb、setCb、cb、parse

.getHandle('eval')(object)

作用：eval方法调用监控封装，跳转MDN文档

该拓展应用后会将代码字符串中的debugger去除，如果我们自己想要断点可以使用sdDebugger代替

params:

• object: 包含日志打印、回调钩子对象，可用属性(参考附录一)：log、cb

eval执行固定值映射：

• !new function(){eval("this.a=1")}().a -> false

.getHandle('func')(object)

作用：Function方法调用监控封装，跳转MDN文档

该拓展应用后会将代码字符串中的debugger去除，如果我们自己想要断点可以使用sdDebugger代替

params:

• object: 包含日志打印、回调钩子对象，可用属性(参考附录一)：log、cb

.getHandle('event')(object)

作用：addEventListener方法的调用监控封装，跳转MDN文档

params:

• object: 包含日志打印、回调、事件过滤的钩子对象，可用属性(参考附录一)：addLog、runLog、log、addCb、runCb、cb、filter

.getHandle('ovserver')(object)

作用：MutationObserver方法的调用监控封装，跳转MDN文档

params:

• object: 包含日志打印、回调、事件过滤的钩子对象，可用属性(参考附录一)：newLog、addLog、runLog、log、newCb、addCb、runCb、cb、filter

.getHandle('timeout')(object)

作用：setTimeout方法的调用监控封装，跳转MDN文档

params:

• object: 包含日志打印、回调钩子对象，可用属性(参考附录一)：log、cb、filter，除了附录一中记录的这三个属性还有一个特殊的time属性，当time属性不传则使用sdenv-extend内部封装的定时器，当time值为数字则使用自带定时器，且time的优先级大于调用时传入的time值

.getHandle('interval')(object)

作用：setInterval方法的调用监控封装，跳转MDN文档

params:

• object: 包含日志打印、回调钩子对象，可用属性(参考附录一)：log、cb、filter，除了附录一中记录的这三个属性还有一个特殊的time属性，当time属性不传则使用sdenv-extend内部封装的定时器，当time值为数字则使用自带定时器，且time的优先级大于调用时传入的time值

.getHandle('dateAndRandom')(object)

作用：用于获取运行时时间值记录及固定时间值与随机数

params:

• object -> datas(object)：指定上下文获取的运行时日期数据
• object -> randomReturn(number)：Math.random方法返回的数值

其中datas的值为指定上下文运行时的产物，可以在浏览器端运行时在断点的位置执行sdenv.utils.getDateData(copy)获取

tools工具方法

待补充...

附录1: extend handle入参对象配置列表