Puppeteer Browser.version() 解析:获取浏览器名称与版本号的 API 用法与源码实现
Puppeteer Browser.version() 解析获取浏览器名称与版本号的 API 用法与源码实现【免费下载链接】puppeteerJavaScript API for Chrome and Firefox项目地址: https://gitcode.com/GitHub_Trending/puppeteer1/puppeteerBrowser.version()是 Puppeteer 中用于获取当前已连接浏览器的名称和版本号字符串的实例方法返回形如Chrome/61.0.3153.0的Promisestring。它在自动化测试中用于环境检测、浏览器兼容性判断、版本门控等功能是理解 Puppeteer 底层 CDP / WebDriver BiDi 协议差异的关键入口。方法签名与返回值Browser.version()在 api/Browser.ts 中作为抽象方法声明class Browser { abstract version(): Promisestring; }方法无参数返回一个Promisestringresolve 值为浏览器的名称加版本号字符串。根据运行环境和浏览器类型返回值的格式存在差异运行环境返回值示例说明无头 Chrome旧 headlessHeadlessChrome/61.0.3153.0名称前缀为HeadlessChrome有头 Chrome 或新 headless 模式Chrome/61.0.3153.0名称前缀为ChromeFirefoxFirefox/116.0a1名称前缀为Firefox官方文档明确提示返回值的格式可能随浏览器的未来版本发布而变化。因此生产代码中不应将返回值与某个固定字符串做严格相等比较而应通过解析前缀或版本号区间来判断特性。CDP 协议的实现调用Browser.getVersionChrome/Chromium 浏览器通过 Chrome DevTools ProtocolCDP通信。在 cdp/Browser.ts 中version()方法的具体实现如下// packages/puppeteer-core/src/cdp/Browser.ts override async version(): Promisestring { const version await this.#getVersion(); return version.product; }它调用了私有方法#getVersion()第 713-725 行该方法内部通过Connection.send发送 CDP 命令Browser.getVersionasync #getVersion(): PromiseProtocol.Browser.GetVersionResponse { if (!this.#version) { this.#version Deferred.createProtocol.Browser.GetVersionResponse(); try { this.#version.resolve( await this.#connection.send(Browser.getVersion), ); } catch (error) { this.#version.reject(error as Error); } } return await this.#version.valueOrThrow(); }这段实现有两个关键设计点结果缓存#version是一个Deferred实例首次调用时发起 CDP 请求之后所有调用都复用缓存的 Promise避免重复向浏览器端发送Browser.getVersion命令。错误传播若 CDP 请求失败例如连接已断开Deferred.reject会将错误传播给所有等待该 Promise 的调用方。version()方法返回的是GetVersionResponse中的product字段。在旧版 headless 模式下该字段值为HeadlessChrome/xx.x.x.x在新 headlessChrome 112 默认或有头模式下则为Chrome/xx.x.x.x。这与userAgent()方法第 685-688 行返回userAgent字段的逻辑形成对照——两者共用同一个#getVersion()缓存但提取的字段不同。WebDriver BiDi 协议的实现对于通过 WebDriver BiDi 协议连接的浏览器如 Firefox 的 BiDi 模式bidi/Browser.ts 中的实现直接拼接内部字段// packages/puppeteer-core/src/bidi/Browser.ts override async version(): Promisestring { return ${this.#browserName}/${this.#browserVersion}; }#browserName和#browserVersion在 BiDi 连接建立时从session.new的 capabilities 响应中提取。这种实现不依赖额外的协议命令调用而是在会话初始化阶段就已经拿到了版本信息因此version()的调用几乎是零开销的。实际用法示例以下代码演示了如何启动浏览器并获取版本号import puppeteer from puppeteer; const browser await puppeteer.launch(); const version await browser.version(); console.log(version); // 例如: Chrome/131.0.6778.204 或 HeadlessChrome/131.0.6778.204 // 版本门控示例判断是否为 Chrome 149 const majorVersion parseInt(version.match(/\d/)?.[0] ?? 0, 10); if (majorVersion 149) { console.warn(某些功能需要 Chrome 149 或更高版本); } // 判断是否为 headless 模式 const isHeadless version.startsWith(HeadlessChrome); console.log(当前运行模式: ${isHeadless ? 无头 : 有头}); await browser.close();上述版本门控模式在 Puppeteer 源码中本身就有应用。在 cdp/Browser.ts 的create静态方法中当用户传入allowlist选项时会主动调用#getVersion()解析主版本号并检查是否满足最低要求if (allowlist) { const version await browser.#getVersion(); const majorVersion parseInt( version.product.match(/\d/)?.[0] ?? 0, 10, ); if (majorVersion 149) { throw new Error(The allowlist option require Chrome 149 or greater.); } }这说明version()的返回值在 Puppeteer 内部不仅用于用户侧检测也是实现特性门控的基础设施。与userAgent()方法的区别方法返回内容示例Chrome示例Firefoxbrowser.version()名称/版本号Chrome/131.0.6778.204Firefox/134.0browser.userAgent()完整 User-Agent 字符串Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36Mozilla/5.0 (X11; Linux x86_64; rv:134.0) Gecko/20100101 Firefox/134.0version()返回的是简洁的标识字符串适合用于版本比较和程序逻辑判断userAgent()返回的是完整的 HTTP User-Agent适合用于需要精确匹配 UA 的场景如反爬检测模拟。两者在 CDP 实现中共用同一个Browser.getVersion命令的结果缓存第 680-688 行不会产生额外的协议调用开销。测试验证Puppeteer 仓库中的 test/src/browser.test.ts 包含了针对Browser.version()的专项测试describe(Browser.version, function () { it(should return version, async () { const {browser} await getTestState(); const version await browser.version(); expect(version.length).toBeGreaterThan(0); expect(version.toLowerCase()).atLeastOneToContain([firefox, chrome]); }); });该测试验证了两个核心不变量返回值非空返回值不区分大小写必须包含firefox或chrome字样。这确保了无论底层是 ChromeCDP 或 BiDi还是 Firefoxversion()的返回值都遵循名称/版本的基本格式约定。注意事项与最佳实践不要在browser.close()之后调用CDP 实现依赖活动连接连接断开后调用将抛出错误。BiDi 实现不受此影响因为它从会话初始化时就缓存了版本信息。不要依赖固定格式文档明确声明返回值格式可能随浏览器版本变化。建议通过正则提取数字部分做版本比较而非字符串全等匹配。区分 headless 与有头模式旧版 headless Chrome 返回HeadlessChrome/...前缀新 headless 和有头模式返回Chrome/...前缀。如果需要判断运行模式应使用version.startsWith(Headless)而非!version.startsWith(Chrome)。版本缓存的语义CDP 实现中版本信息在首次version()调用时被缓存之后不会更新。由于浏览器进程在运行期间版本号不会变化这是合理的设计。相关文档Browser 类完整 APIBrowser.userAgent() 方法Browser 类源码抽象定义CDP Browser 实现BiDi Browser 实现Browser 测试用例【免费下载链接】puppeteerJavaScript API for Chrome and Firefox项目地址: https://gitcode.com/GitHub_Trending/puppeteer1/puppeteer创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

C#部署YOLOv8:OpenVINO与TensorRT多引擎工业视觉实战

C#部署YOLOv8:OpenVINO与TensorRT多引擎工业视觉实战

简介:本资源面向C#开发者与计算机视觉工程师,提供YOLOv8模型在OpenVINO与TensorRT两大高性能推理平台上的完整C#部署方案,解决跨平台模型集成难、C#生态缺乏成熟推理封装等实际工程痛点,适用于工业质检、智能安防、边缘端实时检测…

2026/11/17 2:29:01 阅读更多 →
高质量人体骨骼图像分割数据集:面向骨科临床的解剖级CT/MRI标注

高质量人体骨骼图像分割数据集:面向骨科临床的解剖级CT/MRI标注

简介:本资源是面向医学图像分析研究者与深度学习初学者的人体骨骼多类别分割数据集,专为脊柱解剖结构识别与分割模型训练/验证设计,覆盖L5椎体、椎管、L5/S1椎间盘间隙等共19个解剖部位的像素级标注。数据集严格划分为训练集(约28…

2026/11/17 2:29:01 阅读更多 →
PHP实战:手写Bing搜索爬虫,解析HTTP请求与DOM解析核心技术

PHP实战:手写Bing搜索爬虫,解析HTTP请求与DOM解析核心技术

简介:这是一套面向PHP初学者与Web开发者的Bing搜索引擎集成实践源码,帮助开发者快速掌握如何通过PHP调用微软Bing Web Search API实现网页搜索功能。资源包含27个文件,总大小148KB,涵盖4个核心PHP脚本(如config.php、s…

2026/11/11 9:29:34 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻