playwright-browser-context-launch-rules

Playwright 浏览器上下文启动规则指南与说明 1. 浏览器上下文启动规则概述 - 浏览器上下文（BrowserContext）是 Playwright 中用于隔离浏览器会话的轻量级容器。 - 每个上下文拥有独立的 cookies、本地存储、会话存储和权限设置，适用于模拟多个用户或并行测试场景。 - 上下文启动规则用于控制上下文的创建方式、资源配置及行为策略。 2. 启动参数配置 - `viewport`：设置视口大小（如 `{ width: 1280, height: 720 }`），默认为 `{ width: 1280, height: 720 }`。 - `userAgent`：自定义用户代理字符串，用于模拟特定设备或浏览器。 - `locale`：设置语言环境（如 `'zh-CN'`），影响浏览器语言及格式化行为。 - `timezoneId`：指定时区（如 `'Asia/Shanghai'`），用于时间相关操作。 - `geolocation`：设置地理位置（需配合 `permissions` 使用），格式为 `{ latitude: 39.9042, longitude: 116.4074 }`。 - `permissions`：授予特定权限（如 `['geolocation', 'notifications']`）。 - `colorScheme`：指定颜色主题（`'light'` 或 `'dark'`），影响页面样式。 - `deviceScaleFactor`：设备像素比（如 `2` 表示 Retina 屏幕）。 - `isMobile`：标识是否为移动设备（布尔值），影响触摸事件与视口行为。 - `hasTouch`：是否支持触摸事件（布尔值）。 3. 上下文隔离与复用 - 每个上下文完全独立，避免测试间状态污染。 - 可通过 `browser.newContext()` 创建新上下文，或通过 `browser.contexts()` 获取现有上下文。 - 支持上下文复用：在测试套件中可共享上下文以提升性能，但需确保测试间无依赖。 4. 启动策略建议 - 并行测试：为每个测试用例创建独立上下文，确保隔离性。 - 性能优化：在安全前提下复用上下文，减少启动开销。 - 模拟真实用户：合理配置 `userAgent`、`viewport` 和 `deviceScaleFactor` 以匹配目标设备。 - 地理位置与权限：仅在需要时启用，避免不必要的资源消耗。 5. 错误处理与调试 - 启动失败时检查浏览器类型（Chromium、Firefox、WebKit）是否支持指定参数。 - 使用 `context.on('page')` 监听页面创建事件，便于调试。 - 启用 Playwright 的调试模式（`PWDEBUG=1`）查看上下文启动日志。 6. 示例代码 ```javascript const { chromium } = require('playwright'); (async () => { const browser = await chromium.launch(); const context = await browser.newContext({ viewport: { width: 1920, height: 1080 }, userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36', locale: 'zh-CN', timezoneId: 'Asia/Shanghai', geolocation: { latitude: 39.9042, longitude: 116.4074 }, permissions: ['geolocation'], colorScheme: 'light' }); const page = await context.newPage(); await page.goto('https://example.com'); await browser.close(); })(); ``` 7. 注意事项 - 避免在上下文中直接...

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

相关资产