playwright v1.63.0 官方变更记录 在2026年9月4日正式发布，这次更新最核心的两个新能力是测试锁和跨frame定位。测试锁专门针对多用例争抢共享资源的场景：所有锁名相同的测试，不管跨文件、跨worker实例还是跨不同项目，都不会并发执行，其余没加同名锁的测试还是可以正常并行跑。至于跨frame定位，现在调用page.framelocator()或者frame.framelocator()的时候不传选择器，就能直接遍历所有子frame树找元素，省掉了先定位iframe再切进内部查找控件的两步操作。
来源：Playwright 官方 GitHub 发布记录
测试锁刚好补上了过去测试并行执行时一直缺失的资源协调能力。之前跑多worker并行测试的时候，经常遇到多个用例同时修改同一个账号设置、外部服务状态或者全局共享资源的问题，哪怕单条用例单独跑全过，放到并行环境里也会互相干扰，莫名其妙出故障。1.63.0版本里，你既可以给单条测试单独声明lock属性，也能通过test.describe.configure()给一整组用例批量加锁；只要锁名相同的用例就会自动串行排队，其他锁名不一样、或者没声明锁的测试，还是能保持并行，不用为了避免冲突把整套测试都改成单worker串行跑。
注意锁名得在整个项目里统一规范，只有锁标识完全相同的测试才会互相排队等执行。它没法替代测试数据隔离，也不会自动帮你清理外部服务的残留状态——要是你的用例本身就依赖上一次运行留下的脏数据，就算串行跑也只是减少冲突概率，没法保证每次测试结果都稳定可复现。升级的时候建议先给用到共享账号、全局配置、单实例独占服务的用例加锁，跑一段时间观察CI的执行时长和失败率变化，别上来就给全量测试套同一个锁，反而拖慢整体速度。
来源：Playwright 官方版本说明
跨 frame 搜索有明确边界
新版定位器在没有传入selector时，只会向下遍历当前frame的所有子树找元素，后续写的定位链也始终限定在同一个frame内部，不会跨多个frame跳转。如果匹配到的元素同时出现在多个不同frame里，Playwright会直接抛出报错，不会随便选一个返回。这个边界限制对结构复杂的页面来说特别重要：定位代码写得短，不代表就没有歧义。要是页面上多个不同frame里有同名同属性的按钮，你还是得先缩小父元素范围、补充唯一识别条件，不然运行的时候就会收到「匹配结果不唯一」的报错提示。
1.63.0的官方发布记录还列了不少其他更新：新增只匹配可见元素的locator.visible()、支持给测试步骤加副标题和自定义参数、Trace工具里新增Aria属性和屏幕快照展示、补充API请求时序记录等。平台支持策略也有调整：Ubuntu 20.04之后不再列入官方支持范围；之前处于实验阶段的React、Vue组件测试包会停止更新，官方引导大家迁移到1.62版本就已经推出的stories测试模型。维护老项目的时候别光盯着新增API尝鲜，升级前一定要先检查CI所用的系统版本、组件测试相关依赖是否还在官方支持列表里。
整体来看，1.63.0的影响主要集中在三块：测试并行资源协调、iframe定位逻辑、现有测试基础设施的兼容维护。测试锁帮大家在共享资源用例不冲突、和全量测试尽可能并行之间找到平衡点；无选择器的frame搜索能简化不少定位代码，但还是要注意处理多frame下的匹配歧义；平台支持的变动也给要升级旧环境的团队划好了明确的检查清单。正式全量升级之前，可以先挑一批有代表性的用例跑一轮验证，确认锁的等待逻辑、跨frame匹配的唯一性、Linux运行器版本都没问题，再推广到整条CI流水线使用。
