源码教程：生命周期、导航与页签

本章从 PlaywrightService.start、BrowserInstance 和页签操作方法入手。共享浏览器策略详见浏览器与登录态。

1. 启动不是每个任务都创建一个浏览器

start 先解析 browser、headless、profile 等配置，再复用或创建共享浏览器，将任务 ID 与 BrowserInstance 关联。任务持有自己的页签集合和当前 Page；多个任务可能共用同一个 BrowserContext，所以页签隔离不等于 Cookie 隔离。

注册层默认 headless=true，没有指定 ID 时由服务生成。返回不仅有 id，还有请求浏览器与实际浏览器信息、参数是否被采纳、profile 是否见过等诊断字段。选中某浏览器不能证明账号已经登录，仍要读实际页面。

{"method":"start","params":{"headless":true,"browser":"chrome"}}

先保存返回 ID，再调用后续命令。共享进程首次启动未完成时，先用 list_tasks 观察状态，不重复创建同一任务。

close 只关闭指定任务拥有的页签并移除任务；最后一个任务结束后才释放共享浏览器。shutdown 则关闭全部任务与共享浏览器，但不终止 Java 服务。二者不应混用。

2. 导航实现与结果校验

导航成功后应重取快照，旧 DOM 索引属于旧页面。页面 URL 相同也可能经过 SPA 重建，不能据此长期缓存 Locator 的索引映射。

{"id":"1001","method":"go_to_url","params":{"url":"https://example.com"}}

3. 页签是任务内的列表

get_tabs 返回任务拥有的页签；new_tab 在共享上下文创建 Page，登记到当前任务，并按可选 URL 导航。由网页弹出的页签也需要被事件监听归属到任务。不能直接使用整个 Context 的 Page 列表替代任务列表，否则会操作其他任务的页面。

pageIndex 从 0 开始。文本形式的 browser_state 展示序号可能从 1 开始，不可照抄为参数。新页签出现也不保证当前 Page 已切换，先 get_tabs 再决定。

4. 本地验证

在本地测试页面加入一个 target="_blank" 链接，启动两个任务。验证新页签只属于触发它的任务；关闭其中一个任务后，另一个仍能读取标题。再验证最后一个任务关闭后的资源释放，以及不存在 ID、越界 pageIndex 的错误返回。

人工验证页面不要用 reload 作为常规排障手段。关闭或重启浏览器前，也要考虑其他任务是否仍在使用共享上下文。

注册参数与 Java 入口

以下按 CommandTable 实际读取参数整理。* 表示注册层使用必填读取器；其余字段省略后由服务决定默认行为。带条件的入口仍需满足正文说明，例如上传文件来源、元素定位二选一。外层 id 不重复列出。