UD5工具箱
术语解释
理解以下核心术语将帮助您更好地使用 Chrome DevTools Protocol 命令构建器，并掌握浏览器调试的底层原理。
Chrome DevTools Protocol (CDP)
定义：Chrome DevTools Protocol 是 Chrome 浏览器提供的一套底层调试接口协议，通过 WebSocket 进行通信，允许外部工具控制浏览器行为。它是 Chrome DevTools 面板背后使用的同一套协议，功能极其强大，涵盖页面控制、网络监控、性能分析等各个方面。
与工具的关系：本工具的核心功能就是帮助开发者可视化构建 CDP 命令。您无需直接编写 JSON 格式的 CDP 命令，通过本工具的可视化界面即可快速生成标准命令。
Domain（域）
定义：CDP 中的功能分组单位，每个 Domain 包含一组相关的调试方法。例如 Page 域包含页面导航、截图等方法，Network 域包含网络请求相关的方法。域的划分遵循功能聚合原则，将相同功能领域的方法归为一组。
与工具的关系：本工具的域选择器让开发者能够快速定位到需要的功能分组，通过层级结构直观浏览 CDP 的功能分类，无需记忆所有域和方法的对应关系。
Method（方法）
定义：CDP 中的具体操作命令，格式为 Domain.methodName（如 Page.navigate、Runtime.evaluate）。每个方法执行特定功能，并可能包含输入参数和返回结果。方法是 CDP 的基本操作单元。
与工具的关系：在本工具中选择域后，会显示该域下的所有方法列表。选择具体方法后，工具会自动展示对应的参数表单，帮助开发者快速构建完整命令。
Params（参数）
定义：CDP 命令中 method 字段后的参数对象，包含该方法所需的输入值。参数格式为 JSON 对象，不同方法的参数结构各不相同。有些参数是必需的，有些是可选的，部分参数支持默认值。
与工具的关系：本工具的参数编辑器会根据所选方法动态生成对应的参数表单，开发者无需手动构建复杂的嵌套 JSON 结构，通过填写表单即可完成参数设置。
Command ID（命令 ID）
定义：CDP 命令中的 id 字段，是一个整数值，用于在 WebSocket 通信中匹配请求与响应。同一连接中每个命令的 ID 必须唯一。当浏览器返回响应时，会携带对应的 id 值，客户端据此匹配哪条响应对应哪条请求。
与工具的关系：本工具提供命令 ID 管理功能，支持自动递增和手动设置，确保每次生成的命令使用唯一的 ID，避免通信过程中的响应匹配混乱。
WebSocket
定义：一种在单个 TCP 连接上进行全双工通信的协议。CDP 使用 WebSocket 作为底层传输协议，实现浏览器与外部工具之间的实时双向通信。浏览器在指定端口监听 WebSocket 连接，外部工具通过该连接发送命令和接收响应。
与工具的关系：本工具生成的 JSON 命令通过 WebSocket 发送给 Chrome 浏览器。开发者需要先建立 WebSocket 连接，然后发送本工具生成的命令。
CDP Session（CDP 会话）
定义：Puppeteer 和 Playwright 中用于与 CDP 通信的会话对象。通过创建 CDP Session，可以绕过高级 API 直接发送原始 CDP 命令。CDP Session 维护了与浏览器的底层通信通道。
与工具的关系：本工具生成的 Puppeteer 示例代码展示了如何创建和使用 CDP Session，让开发者了解如何将生成的命令集成到 Puppeteer 项目中。
Event（事件）
定义：CDP 中浏览器主动推送的通知消息，当特定条件满足时触发。例如页面加载完成（Page.loadEventFired）、网络请求发送（Network.requestWillBeSent）等。事件消息不包含 id 字段，与命令响应不同。
与工具的关系：虽然本工具主要构建命令（请求），但理解事件概念有助于开发者设计完整的 CDP 通信流程，正确处理浏览器的异步通知，构建健壮的调试脚本。