Playwright中baseURL路径处理机制解析

Playwright作为现代Web自动化测试工具，在处理多语言网站测试时，其baseURL配置与路径解析机制需要特别注意。本文将深入分析Playwright的URL处理逻辑，帮助开发者正确配置多语言站点的测试环境。

问题现象

当开发者将多语言站点的特定语言路径（如https://www.my-domain.com/en/）配置为baseURL后，使用page.goto('/')导航时，会发现语言路径段/en被意外剥离，导致无法正确访问目标页面。

技术原理

Playwright的URL解析严格遵循WHATWG URL标准规范。当baseURL包含路径部分时：

1. 绝对路径导航（以/开头）会完全替换baseURL的路径部分
2. 相对路径导航（以./或../开头）会基于baseURL的完整路径进行解析
3. 空路径导航（''）会保留baseURL的完整路径

解决方案

针对多语言站点的测试场景，推荐以下实践方式：

1. 使用空路径导航：page.goto('')会完整保留baseURL中配置的语言路径
2. 使用相对路径导航：page.goto('./')同样可以保持语言路径不变
3. 避免绝对路径：page.goto('/')会剥离所有路径段，只保留域名

最佳实践

对于需要频繁切换语言环境的测试项目，建议：

1. 创建语言环境相关的fixture，封装导航逻辑
2. 在测试用例中明确语言路径的上下文
3. 结合Playwright的locale配置实现端到端的多语言测试

// 正确配置示例
const config = {
  use: {
    baseURL: 'https://www.my-domain.com/en/'
  }
}

// 测试用例中的导航方式
test('should navigate to homepage', async ({ page }) => {
  await page.goto(''); // 保持/en路径
  // 或
  await page.goto('./'); // 同样保持/en路径
});

理解这些URL处理机制，可以帮助开发者更高效地构建多语言网站的自动化测试套件，确保测试路径的准确性。