浏览器与 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 输出。

性能验收不要只追求固定毫秒阈值。更可靠的标准是同一操作不会重复渲染、列表结构变化使用批量提交、单项变化不替换无关节点,并且数据规模增加时没有明显的长任务或持续内存增长。必要时再用浏览器性能工具记录证据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

调试、测试与工程检查

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通