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

安装初始化与调用

会自动判断是否已经初始化，初始化成功后挂载到window.sdenv，并返回实例对象sdenv（用于链式调用）

node端

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

浏览器端

1. 打包文件下载：https://raw.githubusercontent.com/pysunday/sdenv-extend/refs/heads/build/sdenv-extend-iife.min.js，注意缓存延迟！
2. head内引入：<script type="text/javascript" charset="utf-8" src="/path/to/sdenv-extend-iife.js"></script>
3. 初始化：new SdenvExtend()

挂载handler拓展方法

使用extend handle拓展方法，建议调用代码放在程序代码执行前，示例：

window.sdenv
  .getHandle('battery')('charging_success')
  .getHandle('eval')()
  ...
  .getHandle('connection')();

部分handler配置项后移，使用getConfig方法传入新配置项，新配置项会与默认配置项合并，如：

window.sdenv.getConfig('window')({ log: true })

调用工具方法

将常用工具方法放在sdenv.tools中方便外部调用，如：sdenv.tools.wrapFunc、sdenv.tools.monitor等

查看代码执行环境

使用sdenv.config.isNode及sdenv.config.envType可以判断当前程序运行环境，如：

• 纯node环境：isNode（true）、envType（node）
• node+vm环境：isNode（false）、envType（node）
• 浏览器环境：isNode（false）、envType（browser）

原始值缓存

sdenv会缓存原始值，如window及未经handler处理过的原始值，通过sdenv.memory获取，如：

1. sdenv中环境模拟是在browser目录下，此时通用方法只接收sdenv变量，使用sdenv.memory.window获取window值
2. 使用名为interval的handler后，使用sdenv.memory.setInterval获取原生setInterval值

API

config配置项设置

extend handle拓展方法

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

.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('window')(object)

作用：代理window变量，用于打印window代理操作及控制执行结果。

注意：该方法只在node环境下有效

params:

• object: 包含日志打印、回调、数据处理的钩子对象，可用属性(参考附录一)：log、parse
• object.windowGetterUndefinedKeys（Array）: 外部读取window属性时返回undefined
• object.windowGetterErrorKeys（Array）: 外部读取window属性时直接报错
• object.windowGetterWinKeys（Array）: 外部读取window属性时返回window自身

该handle已经默认内嵌到sdenv中，无需手动开始，并提供getConfig方法在使用时动态设置配置项，如: sdenv.getConfig('window')({ log: true })

.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('indexDB')(object)

作用：IDBFactory.prototype.open方法的调用监控封装，跳转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('request')(object)

作用：XMLHttpRequest类的实例化监控封装，跳转MDN文档

params:

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

.getHandle('requestFileSystem')(object)

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

params:

• object: 包含日志打印、回调、事件过滤的钩子对象，可用属性(参考附录一)：log、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入参对象配置列表

属性名 | 类型 | 作用 | 默认值 ------ | ---- | ---- | ------ getLog | boolean | 开启get日志 | - setLog | boolean | 开启set日志 | - addLog | boolean | 开启方法调用日志 | - runLog | boolean | 开启回调运行日志 | - newLog | boolean | 开启实例化过程日志 | - log | boolean | 同时开启get和set日志 | - getCb | function | get的回调 | - setCb | function | set的回调 | - addCb | function | 方法调用的回调 | - runCb | function | 回调运行的回调 | - newCb | function | 实例化过程的回调 | - cb | function | 同时设置get和set回调，回调里设置断点更友好 | - parse | function | set最终值时执行 | (val) => val filter | function | 返回false则抛弃该项代码运行 | (...params) => true