端到端测试

概述

code-server 的端到端测试框架使用 Playwright 自动化浏览器交互，并在不同浏览器中验证 code-server 的功能。这些测试会启动 code-server 的独立实例，通过浏览器与它们进行交互，并验证预期的行为。

来源：test/package.json1-31 test/playwright.config.ts1-44 test/e2e/baseFixture.ts1-65

测试架构

E2E 测试系统遵循页面对象模型（Page Object Model）模式，将测试逻辑与 UI 交互代码分离。这使得测试更易于维护和阅读。

来源：test/e2e/models/CodeServer.ts1-598 test/e2e/baseFixture.ts1-65

关键组件

CodeServer 类

CodeServer 类负责启动和管理用于测试的 code-server 实例。它提供了以下方法：

使用自定义参数和环境启动新的 code-server 进程
获取 code-server 运行的地址
为测试创建隔离的工作区
执行 code-server 命令
测试完成后关闭 code-server 进程

此类确保每个测试都有自己独立的 code-server 实例和干净的环境。

来源：test/e2e/models/CodeServer.ts37-260

CodeServerPage 类

CodeServerPage 类实现了页面对象模型（Page Object Model）模式，并提供了一个用于与 code-server UI 交互的高级 API。它封装了 Playwright 的 Page 对象，并提供了特定于 code-server 的方法，从而使测试更易于阅读和维护。

来源：test/e2e/models/CodeServer.ts262-598

测试夹具

端到端测试使用自定义的 fixture，这些 fixture 提供了已初始化的 CodeServer 和 CodeServerPage 实例。这些 fixture 负责 code-server 实例和浏览器自动化的设置与拆卸。

来源：test/e2e/baseFixture.ts11-38

测试执行流程

下图展示了一个典型端到端测试的流程

来源：test/e2e/baseFixture.ts1-65 test/e2e/models/CodeServer.ts37-260

测试类别

端到端测试套件涵盖了 code-server 功能的几个关键领域

测试类别	描述	源文件
身份验证	测试登录功能、密码验证和速率限制	test/e2e/login.test.ts
编辑器核心	测试基本的编辑器功能和可见性	test/e2e/codeServer.test.ts
终端	测试集成终端和环境变量	test/e2e/terminal.test.ts
扩展	测试扩展加载和功能	test/e2e/extensions.test.ts
UI 集成	测试菜单导航和对话框	test/e2e/openHelpAbout.test.ts