Browsertime 实战指南:sitespeed.io 核心浏览器测试引擎的安装、配置与指标采集 测试性能剖析指标监控【免费下载链接】sitespeed.iositespeed.io is an open-source tool for comprehensive web performance analysis, enabling you to test, monitor, and optimize your website’s speed using real browsers in various environments.项目地址https://gitcode.com/gh_mirrors/si/sitespeed.io点击查看免费下载Browsertime 是 sitespeed.io 的心脏它驱动真实浏览器访问 URL或执行脚本运行内置 JavaScript 探针、录制浏览器视口视频、采集 HAR 与各类性能指标。本文基于官方文档 Browsertime 文档入口 及其 Introduction、Installation、Configuration、Details、Graphite 各子页面编写并结合本仓库中的源码browsertime 插件、CLI 选项定义 等逐层展开帮助你在 Docker 或 Node.js 环境下安装运行 Browsertime、完整理解其配置项与底层调用链并将采集到的指标接入监控体系。Browsertime 是什么四大核心能力Browsertime 的定位可以概括为一句话驱动真实浏览器、运行你的 URL或脚本、收集性能数据。它既是 sitespeed.io 的测试引擎也可以作为独立命令行工具或 JavaScript 库使用。从 Introduction 文档看它具体做四件事驱动浏览器桌面端的 Chrome、Firefox、Edge 和 SafariAndroid 上的 Chrome/Firefox以及 iOS 上有限支持的 Safari运行 JavaScript 探针页面就绪后运行一组内置脚本外加你自定义的任意脚本录制浏览器视口视频用于计算 Visual MetricsSpeed Index、First Visual Change、Last Visual Change 等支持 Selenium 风格脚本在导航前、中、后运行脚本——登录用户、点击走通一个流程、测量 SPA 路由切换等。两种常见使用方式作为独立的命令行工具收集某个页面或某条用户旅程的性能指标作为你自己工具内部的 JavaScript runner启动浏览器、运行你的代码并返回结果。一次完整运行的流程如下源自 Introduction 文档的逐步描述你给 Browsertime 一个 URL或脚本以及配置Browsertime 通过 WebDriver 协议Selenium 及对应的 ChromeDriver / GeckoDriver / MSEdgeDriver / SafariDriver启动浏览器FFmpeg 开始录制浏览器视口开启 video 时浏览器导航到目标 URL页面就绪后“就绪”的判定由你决定Browsertime 运行内置探针并收集Navigation Timing / User Timing 条目、绘制时机First Paint、First Contentful Paint、Core Web VitalsLCP、CLS、INP、以及 Chrome trace 中的 Long Tasks 与 CPU 活动--cpu录制 HAR 文件包含页面全部请求与响应SPA 路由切换也会通过 Chrome 的 soft-navigation entry type 被捕获FFmpeg 停止录制视频被分析出 Speed Index 等 Visual Metrics。最终产物是一个包含全部指标的 JSON 文件、一个 HAR 文件、一段视频和截图。安装与第一次运行文档给出两条安装路径见 InstallationDocker 镜像最省事镜像内置 Chrome、Firefox、Xvfb 以及视频录制和 Visual Metrics 所需的全部依赖和Node.js 独立安装。Docker 方式官方镜像为sitespeedio/browsertime容器启动时会自动为你拉起 Xvfb你只需安装 Docker 并运行镜像。Mac 与 Linuxdocker run --rm -v $(pwd):/browsertime sitespeedio/browsertime:28.0.0 --video --visualMetrics https://www.sitespeed.io/WindowsDocker for WindowsC:\Users\Vicky docker pull sitespeedio/browsertime C:\Users\Vicky docker run --rm -v $(pwd):/browsertime sitespeedio/browsertime:28.0.0 https://www.sitespeed.io -b firefox运行结果写入当前目录。注意文档模板中的版本号{% include version/browsertime.txt %}在本仓库中实际解析为 28.0.0而本仓库作为 sitespeed.io 项目依赖的 browsertime 版本为28.3.0见 package.json两者均以 28.x 为基准。独立安装Node.js前置条件Node.js 20 或更高如果要用 TypeScript 编写的导航脚本需要 22.18Linux 上可用 nvm 管理版本npm随 Node.js 附带或 yarn本地安装好的 Chrome 和/或 Firefox。# npm npm install browsertime -g # yarn yarn global add browsertimeWindows 平台官方仅通过 Docker 支持文档明确说明原生 Windows 支持需要核心贡献者投入维护。最简单的一次运行使用 Docker 镜像自带 Chrome、Firefox、Xvfb 与视频依赖docker run --rm -v $(pwd):/browsertime sitespeedio/browsertime:28.0.0 --video --visualMetrics https://www.sitespeed.io/或使用 Node.js 安装browsertime https://www.sitespeed.io这会用 Chrome 加载https://www.sitespeed.io/一次并把带时序数据的 JSON 文件browsertime.json和 HAR 文件browsertime.har写入browsertime-results/www.sitespeed.io/$date/目录。加-n 3即可让同一 URL 测试 3 次每次迭代之间浏览器会重启。核心配置选项Browsertime 高度可配置。运行docker run sitespeedio/browsertime --help可列出全部选项官方文档给出的选项清单见 Configuration原文内嵌 config.md如下browsertime.js [options] url/scriptFile connectivity -c, --connectivity.profile 网络配置文件 [choices: 4g, 3g, 3gfast, 3gslow, 3gem, 2g, cable, native, custom] [default: native] --connectivity.engine 连通性引擎。throttle 适用于 Mac 与基于 tc 的 Linux移动端在有 Humble 环境时可用 humble如果网络限制在 Browsertime 外部完成则用 external [choices: external, throttle, humble] [default: external] Options: --cpu 便捷开关Chrome 上同时启用 chrome.timelineFirefox 上启用 geckoProfile [boolean] --video 录制并保存视频。设为 false 可移除因 visualMetrics 产生的视频要彻底关闭录制需把 video 与 visualMetrics 都设为 false。需要安装 FFMpeg [boolean] --visualMetrics 收集 First Visual Change、SpeedIndex、Perceptual Speed Index、Last Visual Change 等 Visual Metrics。需要 FFMpeg 与 Python 依赖 [boolean] -b, --browser 指定浏览器。Safari 仅限 OS X/iOSEdge 仅限支持 Edge 的系统 [choices: chrome, firefox, edge, safari] [default: chrome] -n, --iterations 测试次数每次测试之间重启浏览器 [number] [default: 3] --config JSON 配置文件路径。也可使用 .browsertime.json会被 Browsertime 通过 find-up 自动发现 --resultDir 设置 Browsertime 产出文件的结果目录 --preURL, --warmLoad 浏览器先访问该 URL再访问你要分析的 URL。用于填充浏览器缓存 --headless 以无头模式运行浏览器。支持 Firefox 与 Chrome [boolean] [default: false] -h, --help 显示帮助 -V, --version 显示版本号 Topics (use browsertime --help topic): timeouts, chrome, android, firefox, selenium, video, edge, safari, screenshot, pageload, proxy, connectivity, debug用--help-all可看到所有细节选项。注意几个要点-n每次迭代都重启浏览器因此默认 3 次迭代得到的是可对比的多组样本便于取中位数等统计量--config与.browsertime.json配置既可显式传 JSON 文件也会被 find-up 机制向上搜索自动发现--preURL预热缓存的轻量方式适合“带缓存二次访问”场景topics 机制完整选项按主题分组browsertime --help chrome、--help video等可分主题查看。sitespeed.io 侧的默认值与扩展选项如果把 Browstime 作为 sitespeed.io 的引擎来驱动本仓库的源码给出了更完整的参数全景。默认配置 中browser: chrome, // 默认浏览器 iterations: 3, // 默认 3 次迭代 connectivity: { profile: native, engine: external, ... }, screenshot: true, // 默认开启截图 screenshotLCP: true, // 针对 LCP 元素的截图 screenshotLS: true, // 针对 Layout Shift 的截图 viewPort: 1366x708, // 默认视口 xvfbParams: { display: 99 } // Xvfb 显示编号lib/cli/options/browser.js 还暴露了文档 CLI 列表之外的大量进阶选项摘选几组关键的选项默认值说明--browsertime.spafalseSPA 测试便捷开关最后网络活动后自动等待 X 秒并用 hash 命名文件--browsertime.timeouts.pageCompleteCheck别名maxLoadTime120000ms等待页面加载完成的最长时间--browsertime.pageCompleteCheck—传入一段 JS反复执行直到返回 true 才认定页面加载完成--browsertime.pageCompleteCheckInactivityfalse在 loadEventEnd 后等待 2 秒网络不活动即结束--browsertime.pageLoadStrategynone导航后文档就绪策略eager/none/normal--browsertime.script/--preScript/--postScript—自定义 JS 脚本可多次传入pre/post 在分析阶段之外运行--browsertime.headlessfalse浏览器内置无头模式注意此模式下无法采集 Visual MetricsChrome 也无法使用 WebExtension即无法加 cookie、requestheader、basic auth--browsertime.viewPort1366x708视口尺寸WidthxHeight--browsertime.requestheader/--cookie/--basicAuth—注入请求头、Cookie、Basic Auth 凭据Chrome/Firefox 支持范围有差异--browsertime.block—屏蔽域名/URL/URL 模式Chrome 可配合--blockDomainsExcept--browsertime.iqrfalse用四分位距IQR过滤离群数据--browsertime.preWarmServerfalse用另一个浏览器实例做不计入测量的预热请求确保被测服务器已热身--browsertime.cjsfalse以 CommonJS 而非 ES module 方式加载.js脚本文件--browsertime.tcpdumpfalse为每个 URL 抓 tcpdump运行用户需 sudo 权限视频与 Visual Metrics 侧的选项lib/cli/options/video.js包括--browsertime.visualMetrics别名speedIndex收集 SpeedIndex、First Visual Change、Last Visual Change 等需要 FFMpeg 与 Python 依赖--browsertime.visualMetricsPerceptual/--visualMetricsContentful分别追加 Perceptual Speed Index 与 Contentful Speed Index--browsertime.videoParams.framerate默认 30、--videoParams.crf默认 23、--videoParams.addTimer默认 true视频叠加计时器与指标标记filmstrip 相关--videoParams.createFilmstrip默认 true、--videoParams.filmstripQuality默认 75、--videoParams.thumbsize默认 400、--videoParams.filmstripDiff生成每帧差异图与视觉不稳定性热图。其中--videoParams.noiseTolerance是一个值得注意的细节参数默认 0 表示沿用“允许 5 个像素差异”的旧行为若观察到 Last Visual Change 明显偏晚但 filmstrip 中并无可见变化文档建议尝试0.05——原因是浏览器可能在页面视觉稳定后仍会重栅格化产生文字边缘的亚像素噪声从而抬高 Last Visual Change、Speed Index 与 VisualComplete95/99。视频与 Speed Index最直观的产出获取视频和 Speed Index 最简单的方式就是用官方 Docker 容器——它自带 VisualMetrics 所需的全部依赖。默认视频会叠加计时器timer overlay并标记各指标触发的时间点加--videoRaw可关掉这些叠加层。官方文档给出的视频示例可见计时器叠加与指标标记。本地构建与测试 Docker 镜像的流程见 Details# 在 browsertime 仓库中构建镜像 docker build -t sitespeedio/browsertime . # 运行一次测试 docker run --rm -v $(pwd):/browsertime-results sitespeedio/browsertime -n 1 --video --visualMetrics https://www.sitespeed.io/网络限速Connectivity与移动端测试网络限速把网络限速可以让性能回归更容易被发现。文档推荐两种方式搭建 Docker network bridge或使用 Throttle 组件参见 Throttle 文档 与 连通性完整指南。对应 CLI 中--connectivity.profile的可选值4g、3g、3gfast、3gslow、3gem、2g、cable、native、custom以及--connectivity.engine的三种取值throttle在 Mac 与基于 tc 的 Linux 上生效humble移动端场景需要自备 Humble 环境external默认网络限制在 Browsertime 之外完成例如通过 Docker 网络。真机移动端测试Browsertime 支持 Android 上的 ChromeVisual Metrics、HAR、视频和 iOS 上的 Safari通过ios_webkit_debug_proxy获取 HARmacOS 下经 USB 支持视频与 Visual Metrics。开始之前安装 ADB 并准备好手机步骤见 移动端测试文档iOS 需要安装ios-webkit-debug-proxymacOS 上brew install ios-webkit-debug-proxy。注意移动端测试不支持 Docker 内运行需要先在本地机器装好 VisualMetrics 依赖若要在真机上做网络限速可以使用 Pi Network Conditioner 之类的工具。browsertime --android https://www.sitespeed.io --video --visualMetrics源码级纵深sitespeed.io 如何驱动 Browsertime文档讲的是“Browsertime 能做什么”本仓库的源码则回答了“sitespeed.io 是怎么用它”。以下结论均可在代码中核实1. 插件入口与默认配置合并。lib/plugins/browsertime/index.js 是 browsertime 插件的入口。open()方法中通过_merge({}, defaultConfig, options.browsertime)把 默认配置 与用户在 CLI/配置文件中传入的browsertime.*选项合并随后向消息队列广播browsertime.setup并注册三组指标过滤器browsertime.pageSummary、browsertime.summary、browsertime.run当limitedRunData开启时改用精简版指标集——这决定了 HTML 报告与数据源各拿到什么粒度的指标。2. 真正的测试执行在 analyzer 中。lib/plugins/browsertime/analyzer.js 从browsertimenpm 包导入BrowsertimeEngine与browserScripts围绕它编排三种运行形态预热preWarmServerpreWarmServer()用独立参数iterations: 1新建一个BrowsertimeEngine访问目标 URL 让服务器热身后关闭并等待preWarmServerWaitTime默认 5000ms——对应 CLI 的--preWarmServer额外剖析轮extraProfileRunextraProfileRun()单独跑一轮只做剖析不采集常规指标。Chrome 下开启chrome.timeline、chrome.coverage及 V8 CPU profiler / blink.debug trace 类别Firefox 下开启geckoProfiler与collectMozLog。这与 CLI 中--enableProfileRun的描述一致——用一次不计入测量的额外运行换取 trace/coverage 数据避免每次迭代都付出剖析开销结果合并mergeProfileCoverage()、mergeProfileModuleCosts()、mergeProfileFunctionCosts()等函数把剖析轮采到的 coverage、cpu.moduleCosts、cpu.functionCosts等以source: profileRun标记合并回主结果供 HTML 报告读取。从源码结构看这套“主运行 剖析运行”双轨设计正是--enableProfileRun/--enableVideoRun选项在引擎层的落地。3. 版本一致性。文档模板中的版本号 28.0.0 与 package.json 中声明的依赖browsertime: 28.3.0属同一 28.x 系列本文所有命令与选项说明均以此版本区间为准若你在其他版本上运行个别选项如noiseTolerance、filmstrip 相关参数可能不存在建议先执行browsertime --help-all核对。把指标发送到 Graphite如果你运行的是独立 Browsertime CLI而不是 sitespeed.io文档给出了一条基于jq与ncnetcat的最简指标上报路径见 Graphite 页面。注意若你运行的是 sitespeed.io应改用其内置的 Graphite 集成见 sitespeed.io 的 Graphite 文档它自带 dashboard 与更丰富的配置。第一步运行 Browsertime 并把browsertime.json生成到tmp目录docker run --shm-size1g --rm -v $(pwd):/browsertime-results sitespeedio/browsertime:28.0.0 --video --visualMetrics --resultDir tmp https://www.sitespeed.io/ -n 5第二步用jq从 JSON 中取出 5 次运行的 SpeedIndex 中位数通过 netcat 发送到 Graphite 的 2003 端口echo browsertime.your.key.SpeedIndex.median $(cat tmp/browsertime.json | jq .statistics.visualMetrics.SpeedIndex.median) date %s | nc -q0 my.graphite.com 2003三个组成部分browsertime.your.key.SpeedIndex.median是发给 Graphite 的 metric key 前缀jq .statistics.visualMetrics.SpeedIndex.median负责从 JSON 中挑出中位数值nc负责把数据送到你的 Graphite 服务器。小结与延伸阅读能做什么驱动 5 类浏览器桌面 Chrome/Firefox/Edge/Safari、Android Chrome/Firefox、iOS Safari、跑内置自定义 JS 探针、录视频算 Visual Metrics、执行 Selenium 风格脚本怎么装Docker推荐依赖全内置或 Node 20 下的npm install browsertime -g怎么跑browsertime url产物为browsertime.jsonbrowsertime.har 视频 截图默认 3 次迭代怎么调--help快速选项 --help topic分主题查看--config/.browsertime.json承载复杂配置怎么接监控jq netcat 直推 Graphite或走 sitespeed.io 内置集成。延伸阅读均为本仓库内文档Introduction、Installation、Configuration 与选项清单、Details、Graphite 上报。赞分享测试性能剖析指标监控【免费下载链接】sitespeed.iositespeed.io is an open-source tool for comprehensive web performance analysis, enabling you to test, monitor, and optimize your website’s speed using real browsers in various environments.项目地址https://gitcode.com/gh_mirrors/si/sitespeed.io点击查看免费下载相关推荐Browsertime 配置完全指南从命令行参数到源码级原理sitespeed.io 核心引擎Browsertime 配置完全指南从命令行参数到源码级原理sitespeed.io 核心引擎 Browsertime 是 sitespeed.io 的核测试性能剖析指标监控sitespeed.io 4.5.0 实战指南Chrome Timeline 采集、Docker 网络限速与浏览器精细配置sitespeed.io 4.5.0 实战指南Chrome Timeline 采集、Docker 网络限速与浏览器精细配置 sitespeed.io 4.5.测试性能剖析指标监控6GB显存也能画专业级图像FLUX.1-dev FP8如何让普通显卡实现AI绘画自由6GB显存也能画专业级图像FLUX.1 dev FP8如何让普通显卡实现AI绘画自由 如果你关注过AI绘画大概率听过这样的劝退话术想玩得爽先上一张基础模型计算机视觉创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考