pixelfactory/playwright

Playwright Server Docker镜像

镜像概述和主要用途

Playwright Server Docker镜像用于运行Playwright服务器，提供远程浏览器实例访问能力。通过WebSocket协议，用户可在本地或远程连接服务器，控制Chromium、Firefox或WebKit浏览器进行网页自动化操作，适用于自动化测试、网页数据采集、跨浏览器兼容性测试等场景。

核心功能和特性

• 多浏览器支持：默认提供Chromium浏览器，可通过配置切换为Firefox或WebKit
• WebSocket远程控制：通过WebSocket协议实现浏览器实例的远程连接与操作
• 端口自定义：支持通过环境变量修改服务器监听端口，适应不同网络环境
• 容器化部署：基于Docker容器化，简化部署流程，确保环境一致性

使用场景和适用范围

• 自动化测试：跨浏览器测试场景，无需本地安装浏览器即可执行测试用例
• 远程网页操作：在服务器端执行网页交互，如表单提交、页面截图、动态内容加载等
• CI/CD集成：集成到持续集成/持续部署流程中，自动化执行浏览器测试步骤
• 开发环境隔离：为开发团队提供统一的浏览器运行环境，避免本地环境差异导致的问题

详细使用方法和配置说明

基本使用方法

启动服务器

使用以下命令启动Playwright Server，默认监听3000端口，使用Chromium浏览器：

bash
docker run -p 3000:3000 pixelfactory/playwright

启动成功后，服务器日志将显示浏览器实例和WebSocket代理的监听信息：

bash
{"@timestamp":"2021-03-05T17:51:26.820Z","log.level":"info","message":"chromium server listening on ws://127.0.0.1:44227/8496b4a530c6d5ead24fe7f112fa609d","ecs":{"version":"1.6.0"}}
{"@timestamp":"2021-03-05T17:51:26.832Z","log.level":"info","message":"websocket proxy listening on ws://0.0.0.0:3000","ecs":{"version":"1.6.0"}}

连接服务器

通过WebSocket连接服务器，控制浏览器实例。以下是JavaScript连接示例：

js
const { chromium } = require('playwright');

const browser = await chromium.connect({
  wsEndpoint: 'ws://localhost:3000',
});

const context = await browser.context();
const page = await context.page();

page.goto('https://example.com');

配置说明

更改浏览器类型

通过环境变量BROWSER_TYPE可切换浏览器类型，支持以下值：

• Chromium（默认）：

bash
docker run -p 3000:3000 -e BROWSER_TYPE=chromium pixelfactory/playwright

• Firefox：

bash
docker run -p 3000:3000 -e BROWSER_TYPE=firefox pixelfactory/playwright

• WebKit：

bash
docker run -p 3000:3000 -e BROWSER_TYPE=webkit pixelfactory/playwright

更改监听端口

通过环境变量PORT可自定义服务器监听端口，需确保容器端口映射与配置端口一致：

bash
docker run -p 5000:5000 -e PORT=5000 pixelfactory/playwright