DOM 选择器调试器
持有选择器配置的有状态封装,提供便捷的检测、诊断、等待方法。 适合在浏览器控制台交互使用。
// 创建实例const debugger_ = new DomDebugger({ toolbar: '.bar-top', table: '.art-table', customPanel: (root) => root.querySelector('[data-role="panel"]')})// 同步检测debugger_.check()// 获取结构化诊断报告const report = debugger_.diagnose()// 获取格式化文本console.log(debugger_.diagnoseText())// 异步等待某个选择器出现const result = await debugger_.waitFor('toolbar', { timeout: 3000 })// 重新检测(DOM 变化后)debugger_.check() Copy
// 创建实例const debugger_ = new DomDebugger({ toolbar: '.bar-top', table: '.art-table', customPanel: (root) => root.querySelector('[data-role="panel"]')})// 同步检测debugger_.check()// 获取结构化诊断报告const report = debugger_.diagnose()// 获取格式化文本console.log(debugger_.diagnoseText())// 异步等待某个选择器出现const result = await debugger_.waitFor('toolbar', { timeout: 3000 })// 重新检测(DOM 变化后)debugger_.check()
创建 DomDebugger 实例
选择器配置对象
检测选项
添加或更新选择器配置
要合并的选择器配置
执行选择器检测,更新并返回结果
所有选择器的检测结果
生成结构化诊断报告
如果从未调用 check(),会自动执行一次检测。
诊断报告数组
生成人类可读的格式化诊断文本
多行格式化文本,适合 console 打印
获取最后一次诊断报告
最后一次诊断报告,未诊断过则返回空数组
获取最后一次检测结果
最后一次检测结果,未检测过则返回空数组
获取当前配置的选择器名称列表
选择器名称数组
移除指定名称的选择器
要移除的选择器名称
异步等待指定选择器匹配成功
内部使用 MutationObserver 监听 DOM 变化,超时后返回失败结果。
选择器名称(必须在 selectors 配置中)
等待选项
等待结果
DOM 选择器调试器
持有选择器配置的有状态封装,提供便捷的检测、诊断、等待方法。 适合在浏览器控制台交互使用。
Example