SuperAPI AI 工具集

next-browser

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

用途:next-browser 面向 Next.js 项目调试。它启动一个有头浏览器连接到本地开发服务器,让使用者能像在 DevTools 中一样查看 React 组件树、PPR 静态外壳、页面错误与网络请求。

安装与准备:若 next-browser 不在 PATH 中,用包管理器全局安装 @vercel/next-browser,再执行 playwright install chromium。已安装时可用 next-browser --version 与 npm view @vercel/next-browser version 比较,落后则升级。项目若使用 Next.js v16.2.0-canary.37 或更高版本,内置文档位于 node_modules/next/dist/docs/,做 PPR、Cache Components 等任务前应先阅读该处文档。

使用方式:先 open <url> [--cookies-json <file>] 打开页面,其中 cookies 文件为 [{"name":"session","value":"..."}] 形式,仅 name 与 value 必需。其他命令在没有打开会话时会报错。常用命令包括:goto、push(客户端导航,无参数时显示链接选择器)、back、reload、ssr-goto(查看服务端原始输出)、capture-goto(截图记录加载序列)、tree 与 tree <id>(组件树与单个组件详情)、viewport、screenshot、eval、errors、logs、network 与 network <idx>、page、project、routes、action <id>,以及 ppr lock/ppr unlock、restart-server。

适用场景:验证 SSR 内容、排查水合不匹配、观察 PPR 外壳与预取外壳、定位视觉抖动与加载空隙、检查服务端操作与网络请求。

限制:PPR 需在 next.config 中启用 cacheComponents;ppr lock 时 errors 不上报,需先 unlock。SSR 页面会屏蔽外部脚本。eval 同步执行,不支持顶层 await,需返回结果时用 IIFE 包裹。组件树 ID 仅在下次导航前有效。restart-server 是最后手段,常出现 net::ERR_ABORTED 属预期,需用 goto 重新导航。viewport 变更须用该命令,Playwright 中 window.resizeTo() 无效。其余如具体收费、平台支持等资料暂未提供。