浏览器与 Web API / 系统课时
调试、测试与工程检查
调试、测试与工程检查
任务管理器完成主要功能后,还需要证明它在异常输入、重复初始化和高数据量下仍然可靠。本课建立一条从数据到交互、再到安全与可访问性的检查路径,并用可直接运行的浏览器测试脚本完成回归验证。
学习目标
- 按风险顺序定位空数据、非法输入、重复事件和渲染异常。
- 编写无测试框架依赖的最小回归脚本,验证关键行为。
- 检查 XSS、键盘焦点、批量渲染和销毁清理等工程边界。
建立按风险排序的检查路径
排查时不要随机点击。先确认输入和状态是否正确,再检查事件是否只绑定一次,然后验证渲染结果,最后覆盖安全、键盘和性能边界。这样可以先排除上游错误,避免在错误数据上反复调试样式或 DOM。

用可重复测试覆盖关键场景
下面是一个完整 HTML 测试页。它用简单的 test 和 assert 函数验证空状态、非法输入、重复初始化、XSS 输出、键盘焦点、500 条数据渲染和资源清理。测试不依赖第三方框架,保存后直接在浏览器打开即可。
html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>任务管理器工程检查</title>
</head>
<body>
<pre id="results"></pre>
<script>
// 同一根节点只允许存在一个活动实例,防止重复绑定事件。
const activeApps = new WeakMap();
function createTaskApp(root) {
if (activeApps.has(root)) return activeApps.get(root);
const controller = new AbortController();
let tasks = [];
let nextId = 1;
root.innerHTML = `
<form data-role="form">
<input data-role="input" aria-label="任务标题">
<button type="submit">添加</button>
</form>
<div data-role="content"></div>
`;
const form = root.querySelector('[data-role="form"]');
const input = root.querySelector('[data-role="input"]');
const content = root.querySelector('[data-role="content"]');
function render() {
// 每次结构渲染先离线构建,再一次替换内容区域。
const fragment = document.createDocumentFragment();
if (tasks.length === 0) {
const empty = document.createElement("p");
empty.dataset.empty = "";
empty.textContent = "暂无任务";
fragment.append(empty);
} else {
const list = document.createElement("ul");
for (const task of tasks) {
const item = document.createElement("li");
const title = document.createElement("span");
// 不可信标题只作为文本写入,避免触发 HTML 解析。
title.textContent = task.title;
const removeButton = document.createElement("button");
removeButton.type = "button";
removeButton.dataset.action = "remove";
removeButton.dataset.id = String(task.id);
removeButton.textContent = `删除 ${task.title}`;
item.append(title, removeButton);
list.append(item);
}
fragment.append(list);
}
content.replaceChildren(fragment);
}
function addTask(title) {
const value = title.trim();
if (!value) return false;
tasks.push({ id: nextId++, title: value });
render();
return true;
}
function setTasks(nextTasks) {
tasks = nextTasks.map((task) => ({ ...task }));
nextId = Math.max(0, ...tasks.map((task) => task.id)) + 1;
render();
}
// 所有内部监听器共享同一个 AbortSignal,便于统一清理。
form.addEventListener("submit", (event) => {
event.preventDefault();
if (addTask(input.value)) form.reset();
}, { signal: controller.signal });
content.addEventListener("click", (event) => {
const button = event.target.closest('button[data-action="remove"]');
if (!button) return;
tasks = tasks.filter((task) => task.id !== Number(button.dataset.id));
render();
}, { signal: controller.signal });
const api = {
addTask,
setTasks,
getTasks: () => tasks.map((task) => ({ ...task })),
destroy() {
// 先终止回调,再清空 DOM 和实例缓存。
controller.abort();
root.replaceChildren();
activeApps.delete(root);
}
};
activeApps.set(root, api);
render();
return api;
}
// 最小测试工具固定记录 PASS 或 FAIL,便于重复回归。
const lines = [];
function assert(condition, message) {
if (!condition) throw new Error(message);
}
function test(name, run) {
try {
const detail = run();
lines.push(`PASS ${name}${detail ? `:${detail}` : ""}`);
} catch (error) {
lines.push(`FAIL ${name}:${error.message}`);
}
}
const root = document.createElement("section");
document.body.prepend(root);
const app = createTaskApp(root);
test("空数据", () => {
assert(root.querySelector("[data-empty]"), "未显示空状态");
});
test("非法输入", () => {
assert(app.addTask(" ") === false, "空白标题被接受");
assert(app.getTasks().length === 0, "状态被意外修改");
});
test("重复初始化", () => {
assert(createTaskApp(root) === app, "创建了第二个实例");
});
test("XSS 安全输出", () => {
const payload = '<img src=x onerror="window.__xss = 1">';
app.addTask(payload);
assert(!root.querySelector("img"), "不可信字符串被解析为元素");
assert(root.textContent.includes(payload), "原始文本未完整显示");
assert(window.__xss !== 1, "事件属性被执行");
});
test("键盘焦点", () => {
const button = root.querySelector('button[data-action="remove"]');
assert(button instanceof HTMLButtonElement, "删除控件不是原生按钮");
button.focus();
assert(document.activeElement === button, "按钮无法获得焦点");
});
test("批量渲染", () => {
const data = Array.from({ length: 500 }, (_, index) => ({
id: index + 1,
title: `任务 ${index + 1}`
}));
// 性能值只作观察,不使用跨设备不稳定的固定阈值。
const start = performance.now();
app.setTasks(data);
const elapsed = performance.now() - start;
assert(root.querySelectorAll("li").length === 500, "节点数量不正确");
return `${elapsed.toFixed(2)} ms`;
});
test("资源清理", () => {
app.destroy();
assert(root.childElementCount === 0, "根节点未清空");
assert(!activeApps.has(root), "实例引用仍被缓存");
});
document.querySelector("#results").textContent = lines.join("\n");
</script>
</body>
</html>预期输出
text
PASS 空数据
PASS 非法输入
PASS 重复初始化
PASS XSS 安全输出
PASS 键盘焦点
PASS 批量渲染:<TIME> ms
PASS 资源清理其中 <TIME> 由设备性能和浏览器状态决定,实际数值可能不同。关键验收条件是没有 FAIL,500 个列表项数量正确,危险字符串只作为文本显示,并且销毁后根节点和实例缓存都为空。
定位根因并完成收尾
| 现象 | 第一检查点 | 常见根因 |
|---|---|---|
| 空列表仍显示旧任务 | 状态数组与空状态分支 | 渲染函数未清空旧节点 |
| 一次点击执行两次 | 初始化次数与监听器数量 | 重复调用 addEventListener |
| 删除了错误任务 | data-id 与数值转换 |
字符串 ID 比较或事件目标错误 |
| 输入后出现异常元素 | 输出 API | 将不可信内容写入 innerHTML |
| Tab 无法到达操作按钮 | 控件语义与焦点顺序 | 使用不可聚焦元素模拟按钮 |
| 销毁后仍有日志 | 观察器、计时器和订阅 | 未执行 disconnect 或取消回调 |
定位根因时应保留最小复现:固定输入、固定操作顺序和明确预期。先让问题稳定出现,再修改一个变量并重新运行测试。若一次同时改动数据结构、事件和样式,即使问题消失,也无法确认真正的修复点。
交付前至少完成四类检查:刷新页面后无控制台错误;空白、超长和含特殊字符的标题都有明确行为;鼠标与键盘能完成相同核心操作;连续初始化、批量写入和销毁不会留下重复事件或活动观察器。安全检查必须确认用户内容通过 textContent 或节点 API 输出。
性能验收不要只追求固定毫秒阈值。更可靠的标准是同一操作不会重复渲染、列表结构变化使用批量提交、单项变化不替换无关节点,并且数据规模增加时没有明显的长任务或持续内存增长。必要时再用浏览器性能工具记录证据。
按自己的节奏,确认真正理解。