Playwright Browser Session Management 实战指南用 playwright-cli 实现多会话隔离、状态持久化与外部浏览器接管【免费下载链接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.项目地址: https://gitcode.com/GitHub_Trending/pl/playwrightPlaywright 仓库内置了一套供 Agent 与终端直接调用的playwright-cli命令行工具其会话Session管理机制允许你在同一台机器上并行运行多个互相隔离的浏览器实例每个实例拥有独立的 Cookie、LocalStorage、IndexedDB、缓存、历史记录与标签页并可选择性把浏览器 Profile 持久化到磁盘。读完本文你将掌握命名会话-s的完整用法、list / close / close-all / kill-all / delete-data等生命周期命令、通过PLAYWRIGHT_CLI_SESSION环境变量设定默认会话的技巧以及如何通过 CDP、浏览器渠道名或 Playwright 扩展attach到一个已经在运行的浏览器并在不改动外部浏览器的前提下安全地detach。本文的主体规范来自仓库中的官方技能文档 session-management.md它是面向playwright-cli技能的专项参考页完整技能入口见 SKILL.md文中的原理部分则结合了playwright-cli在仓库中的真实实现具体位于 cli-client 目录 及对应测试 cli-session.spec.ts、cli-killall.spec.ts。命名浏览器会话-s参数与多实例并行playwright-cli的会话是一条命令链上共享同一个浏览器上下文的逻辑单位。使用-sname即--session即可让每条命令精确命中目标浏览器实现真正的并行隔离。# Browser 1认证流程登录态只存在于 auth 会话内 playwright-cli -sauth open https://app.example.com/login # Browser 2公开浏览独立的 cookies、storage互不干扰 playwright-cli -spublic open https://example.com # 后续命令按会话隔离路由 playwright-cli -sauth fill e1 userexample.com playwright-cli -spublic snapshot这段示例说明两个关键事实其一不同-s名称对应完全独立的浏览器进程认证状态与普通浏览互不可见其二即使不传-s所有命令也会被路由到某个确定会话即下文默认浏览器会话。从命令行解析实现看-s只是--session的别名——在 program.ts 中会把args.s归一化为args.session因此两种写法完全等价。会话命令真正执行前会先查注册表并建立 socket 连接在 session.ts 中每个会话在启动时都会在config.socketPath上常驻一个 daemon 进程并监听本地 socket客户端通过该 socket 把后续命令含raw、json选项投递给浏览器若会话尚未打开则报错提示Browser xxx is not open. Runplaywright-cli -sxxx opento start the browser session.。会话隔离属性每个浏览器会话都拥有完全独立的CookiesLocalStorage / SessionStorageIndexedDB缓存Cache浏览历史Browsing history打开的标签页Open tabs也就是说-sauth里登录产生的 Cookie、LocalStorage 绝不会泄漏给-spublic即使两个会话访问同一个站点也会像两台不同的电脑一样互不相识。这是用一套 Playwright 库在单机上模拟多个用户、多种身份并行工作的基础。浏览器会话生命周期命令仓库提供了一组完整的生命周期命令program.ts 中对每个命令都有对应分支处理# 列出所有浏览器会话 playwright-cli list # 停止某个浏览器会话关闭浏览器 playwright-cli close # 停止 default 浏览器 playwright-cli -smysession close # 停止名为 mysession 的浏览器 # 停止所有浏览器会话 playwright-cli close-all # 强制杀死所有 daemon 进程用于清理僵尸 / 失效进程 playwright-cli kill-all # 删除浏览器会话的用户数据profile 目录 playwright-cli delete-data # 删除 default 浏览器数据 playwright-cli -smysession delete-data # 删除 mysession 浏览器数据各命令的语义在源码中非常清晰list会逐个会话探测 socket 连通性并回收失效条目见 program.ts无法连接的会话配置会被当作垃圾清理GC掉因此输出的都是当前真实可用的会话。其--all参数还能跨工作区列出其它项目启动的会话。同时 cli-session.spec.ts 有专门用例覆盖list。close/close-allclose只针对当前会话默认为defaultclose-all则遍历当前客户端注册表内全部会话逐一stop()。若目标会话本来就没运行close会返回wasOpen: false不会报错有测试用例 close non-running session 佐证。kill-all这是一个杀进程兜底命令。在 program.ts 中它按进程命令行特征匹配run-mcp-server、run-cli-server、cli-daemon、cliDaemon.js、dashboardApp.js等模式在 Windows 上通过 PowerShellStop-Process -Force强杀在类 Unix 上对匹配 PID 发送SIGKILL。适合浏览器无响应、close无法优雅退出时使用。delete-data停掉会话后删除该会话对应的.session配置文件与ud-name-*前缀的用户数据目录实现见 session.ts。测试 delete-data 覆盖了默认会话、命名会话与不存在会话三种情况。注意只有使用--persistent/--profile启动的会话才真正在磁盘写有用户数据普通内存会话调用delete-data通常返回existed: false。会话数据存在哪里从 registry.ts 可以确认 daemon 目录位置因平台而异Linux~/.cache/ms-playwright/daemonmacOS~/Library/Caches/ms-playwright/daemonWindows%LOCALAPPDATA%\ms-playwright\daemon在该目录下每个工作区以 CWD 向上查找最近含.playwright的目录或包根目录的 SHA-1 哈希前 16 位标识各自拥有一个子目录会话名以name.sessionJSON 文件形式登记registry.ts持久化用户数据则以ud-name-...目录存放。理解这套落盘结构就能解释为什么delete-data能精准清理某个会话也解释了测试用例 workspace isolation 中不同工作区的会话天然互相隔离的机制。环境变量设置默认会话名当每次敲命令都不想重复-s时可以用环境变量固定默认会话export PLAYWRIGHT_CLI_SESSIONmysession playwright-cli open example.com # 自动使用 mysession 会话实现上registry.ts 的explicitSessionName优先读取命令行传入的session其次回退到process.env.PLAYWRIGHT_CLI_SESSIONresolveSessionName再将两者都没有的情况归一为字面量default。因此会话名解析优先级为命令行-s/--sessionPLAYWRIGHT_CLI_SESSIONdefault。该优先级在 program.ts 计算 attach 会话名时同样生效。常见实战模式并发抓取多个站点把多个浏览器会话放入后台并发启动借助 Bash 的wait汇合后统一采集最后一次性清理#!/bin/bash # 并发抓取多个站点 # 启动所有浏览器 playwright-cli -ssite1 open https://site1.com playwright-cli -ssite2 open https://site2.com playwright-cli -ssite3 open https://site3.com wait # 分别抓取快照 playwright-cli -ssite1 snapshot playwright-cli -ssite2 snapshot playwright-cli -ssite3 snapshot # 清理 playwright-cli close-all由于每个会话是独立的浏览器进程站点间网络请求、Cookie、JS 执行环境完全隔离抓取互不污染总耗时约等于最慢的单站点耗时而非三者之和。A/B 测试会话为不同实验分组各开一个会话用参数化 URL 模拟不同用户体验并逐组截图对比# 测试不同的用户体验 playwright-cli -svariant-a open https://app.com?varianta playwright-cli -svariant-b open https://app.com?variantb # 对比截图 playwright-cli -svariant-a screenshot playwright-cli -svariant-b screenshot同理可扩展到更多分组如variant-c、variant-d最后用playwright-cli -svariant-a close逐个关闭或用close-all一并收尾。持久化 Profile--persistent与--profile默认情况下浏览器 Profile 只保存在内存中关闭即消失。若希望跨命令、跨重启保留登录态与站点数据请使用--persistent或显式指定--profile# 使用持久化 Profile自动生成存放位置 playwright-cli open https://example.com --persistent # 使用自定义目录的持久化 Profile playwright-cli open https://example.com --profile/path/to/profile从 SKILL.md 的说明看二者通常组合-s使用例如playwright-cli -smysession open example.com --persistent会为mysession建立可复用 Profile。源码层面session.ts 会把--persistent与--profile原样透传给 daemon而注册表中每个会话配置registry.ts会记录userDataDir与cli.persistent标记供list展示输出里会显示persistent: true及 userDataDir 路径。持久化会话与存储状态能力互补——把认证后的 state 导出为文件便于复用的做法参见 storage-state.md。附加Attach到正在运行的浏览器attach与open的本质区别是open由 CLI 自己拉起一个全新浏览器而attach连接到一个已经运行的外部浏览器不新开进程。会话配置中以attached?: boolean标记该会话来源见 registry.ts。支持三种接入目标。按渠道名附加Chrome / Edge 渠道通过渠道名连接正在运行的 Chrome 或 Edge 实例。目标浏览器必须先开启远程调试在浏览器地址栏访问chrome://inspect/#remote-debugging并勾选 Allow remote debugging for this browser instance。# 附加到 Chrome playwright-cli attach --cdpchrome # 附加到 Chrome Canary playwright-cli attach --cdpchrome-canary # 附加到 Microsoft Edge playwright-cli attach --cdpmsedge # 附加到 Edge Dev playwright-cli attach --cdpmsedge-dev受支持的渠道包括chrome、chrome-beta、chrome-dev、chrome-canary、msedge、msedge-beta、msedge-dev、msedge-canary。每个渠道在 channelSessions.ts 中都映射了它在 Linux / macOS / Windows 上的真实用户数据目录如 Chrome 的~/.config/google-chrome、~/Library/Application Support/Google/Chrome、%LOCALAPPDATA%\Google\Chrome\User Data用于探测浏览器是否运行并读取其调试端口。需要注意的自动命名规则当用户没有显式提供--session时附加会话会自动以渠道名命名——--cdpmsedge会创建名为msedge的会话。这样对 Chrome 与 Edge 的并行附加不会在default会话上冲突。若想覆盖该默认名传--sessionname即可。这条逻辑在 program.ts 中体现为会话名优先级为explicitSessionName(args.session) ?? attachTarget ?? cdpChannel ?? extensionChannel ?? sessionName。通过 CDP 端点附加连接任何暴露了 Chrome DevTools Protocol 端点的浏览器例如以--remote-debugging-port启动的浏览器、容器/远程调试服务等playwright-cli attach --cdphttp://localhost:9222传入的即浏览器 DevToolsActivePort 对应的http://localhost:port形式调试端点。仓库在list --all时会利用 channelSessions.ts 读取渠道用户目录里的DevToolsActivePort文件并探测端口存活从而发现这类可附加目标。通过浏览器扩展附加连接装有 Playwright 浏览器扩展的浏览器playwright-cli attach --extension若扩展安装在特定渠道中还可以直接写为playwright-cli attach --extensionchrome的形式见 SKILL.md此时 CLI 会先确认该渠道用户数据目录内确实检测到了 Playwright 扩展isPlaywrightExtensionInstalled见 channelSessions.ts。分离Detachdetach用于拆除附加会话而不影响外部浏览器本身# 分离默认附加会话 playwright-cli detach # 分离指定附加会话 playwright-cli -smsedge detach重要约束detach只对通过attach创建的会话有效通过open创建的会话请使用close。若对非附加会话误用detachprogram.ts 会通过output.errorDetachNotAttached明确报错提示。测试用例 attach with session alias 与 detach from browser server 覆盖了完整的附加/分离链路。默认浏览器会话当省略-s时命令会自动落到名为default的会话上# 以下命令都作用于同一个 default 浏览器会话 playwright-cli open https://example.com playwright-cli snapshot playwright-cli close # 停止 default 浏览器因此只需裸敲命令即可完成打开 → 操作 → 关闭的完整流程无需任何会话概念。如果希望隐式命令指向其它会话则使用上文的环境变量方案。浏览器会话的启动配置open启动会话时可叠加多项配置决定浏览器种类、形态与数据持久化方式# 携带配置文件启动 playwright-cli open https://example.com --config.playwright/my-cli.json # 指定浏览器内核 playwright-cli open https://example.com --browserfirefox # 有头模式启动肉眼可见窗口 playwright-cli open https://example.com --headed # 持久化 Profile 启动 playwright-cli open https://example.com --persistent与 SKILL.md 的 Open parameters 一致这些参数还包括--browserchrome、--browserwebkit、--browsermsedge、--mobile通用移动端仿真Chromium 对应 Pixel 10、WebKit 对应 iPhone 17、--deviceiPhone 15、--profile/path/to/profile等。从 session.ts 的实现可见daemon 以脱离终端detached: true的方式派生启动参数headed/mobile/device/browser/persistent/profile/config 等被逐项拼装到子进程命令行stdout 中一旦出现 Daemon listening on 即认为启动成功--config指定的 JSON 则决定会话更底层的浏览器 launch 配置。最佳实践1. 语义化命名会话会话名会出现在所有命令中并成为你心智模型的一部分务必用可读的名称描述用途# 好用途一目了然 playwright-cli -sgithub-auth open https://github.com playwright-cli -sdocs-scrape open https://docs.example.com # 避免无意义泛名 playwright-cli -ss1 open https://github.com2. 用完务必清理会话是常驻 daemon 进程长期堆积会占用内存与磁盘# 任务结束关闭各自浏览器 playwright-cli -sauth close playwright-cli -sscrape close # 或一次性全部关闭 playwright-cli close-all # 若浏览器无响应或残留僵尸进程使用强杀兜底 playwright-cli kill-all仓库测试 close-all 与 cli-killall.spec.ts 分别验证了两类清理路径close-all走优雅的 socket 停服协议kill-all走进程强杀。3. 及时删除过期会话数据持久化 Profile 会占用磁盘废弃的会话应连数据一并清除# 删除过期会话的浏览器数据释放磁盘空间 playwright-cli -soldsession delete-data小结playwright-cli的会话管理是一套名称隔离 daemon 常驻 socket 路由 可选落盘的完整方案用-s名称在单机上并行多套互不可见的浏览器环境用--persistent/--profile让登录态跨会话跨重启存活用list/close/close-all/kill-all/delete-data精确掌控每个会话的生老病死再用attach渠道名 / CDP 端点 / 浏览器扩展把已经运行在用户桌面的浏览器无缝接入自动化流程并在需要时以detach干净退出、绝不破坏用户的真实浏览器。若需要进一步了解与登录态相关的 Cookie / localStorage 存储与复用可继续阅读配套文档 storage-state.md完整的浏览器交互命令清单导航、键盘鼠标、标签页、录制等见 SKILL.md。【免费下载链接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/8 21:17:59 · 阅读 1.2k Playwright Browser Session Management 实战指南：用 playwright-cli 实现多会话隔离、状态持久化与外部浏览器接管
Playwright Browser Session Management 实战指南用 playwright-cli 实现多会话隔离、状态持久化与外部浏览器接管【免费下载链接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.项目地址: https://gitcode.com/GitHub_Trending/pl/playwrightPlaywright 仓库内置了一套供 Agent 与终端直接调用的playwright-cli命令行工具其会话Session管理机制允许你在同一台机器上并行运行多个互相隔离的浏览器实例每个实例拥有独立的 Cookie、LocalStorage、IndexedDB、缓存、历史记录与标签页并可选择性把浏览器 Profile 持久化到磁盘。读完本文你将掌握命名会话-s的完整用法、list / close / close-all / kill-all / delete-data等生命周期命令、通过PLAYWRIGHT_CLI_SESSION环境变量设定默认会话的技巧以及如何通过 CDP、浏览器渠道名或 Playwright 扩展attach到一个已经在运行的浏览器并在不改动外部浏览器的前提下安全地detach。本文的主体规范来自仓库中的官方技能文档 session-management.md它是面向playwright-cli技能的专项参考页完整技能入口见 SKILL.md文中的原理部分则结合了playwright-cli在仓库中的真实实现具体位于 cli-client 目录 及对应测试 cli-session.spec.ts、cli-killall.spec.ts。命名浏览器会话-s参数与多实例并行playwright-cli的会话是一条命令链上共享同一个浏览器上下文的逻辑单位。使用-sname即--session即可让每条命令精确命中目标浏览器实现真正的并行隔离。# Browser 1认证流程登录态只存在于 auth 会话内 playwright-cli -sauth open https://app.example.com/login # Browser 2公开浏览独立的 cookies、storage互不干扰 playwright-cli -spublic open https://example.com # 后续命令按会话隔离路由 playwright-cli -sauth fill e1 userexample.com playwright-cli -spublic snapshot这段示例说明两个关键事实其一不同-s名称对应完全独立的浏览器进程认证状态与普通浏览互不可见其二即使不传-s所有命令也会被路由到某个确定会话即下文默认浏览器会话。从命令行解析实现看-s只是--session的别名——在 program.ts 中会把args.s归一化为args.session因此两种写法完全等价。会话命令真正执行前会先查注册表并建立 socket 连接在 session.ts 中每个会话在启动时都会在config.socketPath上常驻一个 daemon 进程并监听本地 socket客户端通过该 socket 把后续命令含raw、json选项投递给浏览器若会话尚未打开则报错提示Browser xxx is not open. Runplaywright-cli -sxxx opento start the browser session.。会话隔离属性每个浏览器会话都拥有完全独立的CookiesLocalStorage / SessionStorageIndexedDB缓存Cache浏览历史Browsing history打开的标签页Open tabs也就是说-sauth里登录产生的 Cookie、LocalStorage 绝不会泄漏给-spublic即使两个会话访问同一个站点也会像两台不同的电脑一样互不相识。这是用一套 Playwright 库在单机上模拟多个用户、多种身份并行工作的基础。浏览器会话生命周期命令仓库提供了一组完整的生命周期命令program.ts 中对每个命令都有对应分支处理# 列出所有浏览器会话 playwright-cli list # 停止某个浏览器会话关闭浏览器 playwright-cli close # 停止 default 浏览器 playwright-cli -smysession close # 停止名为 mysession 的浏览器 # 停止所有浏览器会话 playwright-cli close-all # 强制杀死所有 daemon 进程用于清理僵尸 / 失效进程 playwright-cli kill-all # 删除浏览器会话的用户数据profile 目录 playwright-cli delete-data # 删除 default 浏览器数据 playwright-cli -smysession delete-data # 删除 mysession 浏览器数据各命令的语义在源码中非常清晰list会逐个会话探测 socket 连通性并回收失效条目见 program.ts无法连接的会话配置会被当作垃圾清理GC掉因此输出的都是当前真实可用的会话。其--all参数还能跨工作区列出其它项目启动的会话。同时 cli-session.spec.ts 有专门用例覆盖list。close/close-allclose只针对当前会话默认为defaultclose-all则遍历当前客户端注册表内全部会话逐一stop()。若目标会话本来就没运行close会返回wasOpen: false不会报错有测试用例 close non-running session 佐证。kill-all这是一个杀进程兜底命令。在 program.ts 中它按进程命令行特征匹配run-mcp-server、run-cli-server、cli-daemon、cliDaemon.js、dashboardApp.js等模式在 Windows 上通过 PowerShellStop-Process -Force强杀在类 Unix 上对匹配 PID 发送SIGKILL。适合浏览器无响应、close无法优雅退出时使用。delete-data停掉会话后删除该会话对应的.session配置文件与ud-name-*前缀的用户数据目录实现见 session.ts。测试 delete-data 覆盖了默认会话、命名会话与不存在会话三种情况。注意只有使用--persistent/--profile启动的会话才真正在磁盘写有用户数据普通内存会话调用delete-data通常返回existed: false。会话数据存在哪里从 registry.ts 可以确认 daemon 目录位置因平台而异Linux~/.cache/ms-playwright/daemonmacOS~/Library/Caches/ms-playwright/daemonWindows%LOCALAPPDATA%\ms-playwright\daemon在该目录下每个工作区以 CWD 向上查找最近含.playwright的目录或包根目录的 SHA-1 哈希前 16 位标识各自拥有一个子目录会话名以name.sessionJSON 文件形式登记registry.ts持久化用户数据则以ud-name-...目录存放。理解这套落盘结构就能解释为什么delete-data能精准清理某个会话也解释了测试用例 workspace isolation 中不同工作区的会话天然互相隔离的机制。环境变量设置默认会话名当每次敲命令都不想重复-s时可以用环境变量固定默认会话export PLAYWRIGHT_CLI_SESSIONmysession playwright-cli open example.com # 自动使用 mysession 会话实现上registry.ts 的explicitSessionName优先读取命令行传入的session其次回退到process.env.PLAYWRIGHT_CLI_SESSIONresolveSessionName再将两者都没有的情况归一为字面量default。因此会话名解析优先级为命令行-s/--sessionPLAYWRIGHT_CLI_SESSIONdefault。该优先级在 program.ts 计算 attach 会话名时同样生效。常见实战模式并发抓取多个站点把多个浏览器会话放入后台并发启动借助 Bash 的wait汇合后统一采集最后一次性清理#!/bin/bash # 并发抓取多个站点 # 启动所有浏览器 playwright-cli -ssite1 open https://site1.com playwright-cli -ssite2 open https://site2.com playwright-cli -ssite3 open https://site3.com wait # 分别抓取快照 playwright-cli -ssite1 snapshot playwright-cli -ssite2 snapshot playwright-cli -ssite3 snapshot # 清理 playwright-cli close-all由于每个会话是独立的浏览器进程站点间网络请求、Cookie、JS 执行环境完全隔离抓取互不污染总耗时约等于最慢的单站点耗时而非三者之和。A/B 测试会话为不同实验分组各开一个会话用参数化 URL 模拟不同用户体验并逐组截图对比# 测试不同的用户体验 playwright-cli -svariant-a open https://app.com?varianta playwright-cli -svariant-b open https://app.com?variantb # 对比截图 playwright-cli -svariant-a screenshot playwright-cli -svariant-b screenshot同理可扩展到更多分组如variant-c、variant-d最后用playwright-cli -svariant-a close逐个关闭或用close-all一并收尾。持久化 Profile--persistent与--profile默认情况下浏览器 Profile 只保存在内存中关闭即消失。若希望跨命令、跨重启保留登录态与站点数据请使用--persistent或显式指定--profile# 使用持久化 Profile自动生成存放位置 playwright-cli open https://example.com --persistent # 使用自定义目录的持久化 Profile playwright-cli open https://example.com --profile/path/to/profile从 SKILL.md 的说明看二者通常组合-s使用例如playwright-cli -smysession open example.com --persistent会为mysession建立可复用 Profile。源码层面session.ts 会把--persistent与--profile原样透传给 daemon而注册表中每个会话配置registry.ts会记录userDataDir与cli.persistent标记供list展示输出里会显示persistent: true及 userDataDir 路径。持久化会话与存储状态能力互补——把认证后的 state 导出为文件便于复用的做法参见 storage-state.md。附加Attach到正在运行的浏览器attach与open的本质区别是open由 CLI 自己拉起一个全新浏览器而attach连接到一个已经运行的外部浏览器不新开进程。会话配置中以attached?: boolean标记该会话来源见 registry.ts。支持三种接入目标。按渠道名附加Chrome / Edge 渠道通过渠道名连接正在运行的 Chrome 或 Edge 实例。目标浏览器必须先开启远程调试在浏览器地址栏访问chrome://inspect/#remote-debugging并勾选 Allow remote debugging for this browser instance。# 附加到 Chrome playwright-cli attach --cdpchrome # 附加到 Chrome Canary playwright-cli attach --cdpchrome-canary # 附加到 Microsoft Edge playwright-cli attach --cdpmsedge # 附加到 Edge Dev playwright-cli attach --cdpmsedge-dev受支持的渠道包括chrome、chrome-beta、chrome-dev、chrome-canary、msedge、msedge-beta、msedge-dev、msedge-canary。每个渠道在 channelSessions.ts 中都映射了它在 Linux / macOS / Windows 上的真实用户数据目录如 Chrome 的~/.config/google-chrome、~/Library/Application Support/Google/Chrome、%LOCALAPPDATA%\Google\Chrome\User Data用于探测浏览器是否运行并读取其调试端口。需要注意的自动命名规则当用户没有显式提供--session时附加会话会自动以渠道名命名——--cdpmsedge会创建名为msedge的会话。这样对 Chrome 与 Edge 的并行附加不会在default会话上冲突。若想覆盖该默认名传--sessionname即可。这条逻辑在 program.ts 中体现为会话名优先级为explicitSessionName(args.session) ?? attachTarget ?? cdpChannel ?? extensionChannel ?? sessionName。通过 CDP 端点附加连接任何暴露了 Chrome DevTools Protocol 端点的浏览器例如以--remote-debugging-port启动的浏览器、容器/远程调试服务等playwright-cli attach --cdphttp://localhost:9222传入的即浏览器 DevToolsActivePort 对应的http://localhost:port形式调试端点。仓库在list --all时会利用 channelSessions.ts 读取渠道用户目录里的DevToolsActivePort文件并探测端口存活从而发现这类可附加目标。通过浏览器扩展附加连接装有 Playwright 浏览器扩展的浏览器playwright-cli attach --extension若扩展安装在特定渠道中还可以直接写为playwright-cli attach --extensionchrome的形式见 SKILL.md此时 CLI 会先确认该渠道用户数据目录内确实检测到了 Playwright 扩展isPlaywrightExtensionInstalled见 channelSessions.ts。分离Detachdetach用于拆除附加会话而不影响外部浏览器本身# 分离默认附加会话 playwright-cli detach # 分离指定附加会话 playwright-cli -smsedge detach重要约束detach只对通过attach创建的会话有效通过open创建的会话请使用close。若对非附加会话误用detachprogram.ts 会通过output.errorDetachNotAttached明确报错提示。测试用例 attach with session alias 与 detach from browser server 覆盖了完整的附加/分离链路。默认浏览器会话当省略-s时命令会自动落到名为default的会话上# 以下命令都作用于同一个 default 浏览器会话 playwright-cli open https://example.com playwright-cli snapshot playwright-cli close # 停止 default 浏览器因此只需裸敲命令即可完成打开 → 操作 → 关闭的完整流程无需任何会话概念。如果希望隐式命令指向其它会话则使用上文的环境变量方案。浏览器会话的启动配置open启动会话时可叠加多项配置决定浏览器种类、形态与数据持久化方式# 携带配置文件启动 playwright-cli open https://example.com --config.playwright/my-cli.json # 指定浏览器内核 playwright-cli open https://example.com --browserfirefox # 有头模式启动肉眼可见窗口 playwright-cli open https://example.com --headed # 持久化 Profile 启动 playwright-cli open https://example.com --persistent与 SKILL.md 的 Open parameters 一致这些参数还包括--browserchrome、--browserwebkit、--browsermsedge、--mobile通用移动端仿真Chromium 对应 Pixel 10、WebKit 对应 iPhone 17、--deviceiPhone 15、--profile/path/to/profile等。从 session.ts 的实现可见daemon 以脱离终端detached: true的方式派生启动参数headed/mobile/device/browser/persistent/profile/config 等被逐项拼装到子进程命令行stdout 中一旦出现 Daemon listening on 即认为启动成功--config指定的 JSON 则决定会话更底层的浏览器 launch 配置。最佳实践1. 语义化命名会话会话名会出现在所有命令中并成为你心智模型的一部分务必用可读的名称描述用途# 好用途一目了然 playwright-cli -sgithub-auth open https://github.com playwright-cli -sdocs-scrape open https://docs.example.com # 避免无意义泛名 playwright-cli -ss1 open https://github.com2. 用完务必清理会话是常驻 daemon 进程长期堆积会占用内存与磁盘# 任务结束关闭各自浏览器 playwright-cli -sauth close playwright-cli -sscrape close # 或一次性全部关闭 playwright-cli close-all # 若浏览器无响应或残留僵尸进程使用强杀兜底 playwright-cli kill-all仓库测试 close-all 与 cli-killall.spec.ts 分别验证了两类清理路径close-all走优雅的 socket 停服协议kill-all走进程强杀。3. 及时删除过期会话数据持久化 Profile 会占用磁盘废弃的会话应连数据一并清除# 删除过期会话的浏览器数据释放磁盘空间 playwright-cli -soldsession delete-data小结playwright-cli的会话管理是一套名称隔离 daemon 常驻 socket 路由 可选落盘的完整方案用-s名称在单机上并行多套互不可见的浏览器环境用--persistent/--profile让登录态跨会话跨重启存活用list/close/close-all/kill-all/delete-data精确掌控每个会话的生老病死再用attach渠道名 / CDP 端点 / 浏览器扩展把已经运行在用户桌面的浏览器无缝接入自动化流程并在需要时以detach干净退出、绝不破坏用户的真实浏览器。若需要进一步了解与登录态相关的 Cookie / localStorage 存储与复用可继续阅读配套文档 storage-state.md完整的浏览器交互命令清单导航、键盘鼠标、标签页、录制等见 SKILL.md。【免费下载链接】playwrightPlaywright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考