Browsertime

运行Docker 单元测试 Windows Edge OSX Safari Linux浏览器

文档 | 更新日志

Browsertime

Browsertime：测量和优化Web性能

Browsertime是一个强大的开源Node.js工具，专为构建自己的性能测量工具的工程师设计。它是sitespeed.io等项目的核心引擎，也是Mozilla用来测量Firefox性能的可信工具。

强大的性能测试： Browsertime允许你对网页进行全面的性能测试，包括页面加载时间、资源加载和用户交互。
深入的指标： 获取广泛的性能指标，如页面加载时间、视觉指标（屏幕上的内容何时绘制）、最大内容绘制（LCP）等，帮助你找出需要改进的地方。
脚本功能： 使用JavaScript脚本自定义测试和用户交互，实现高级场景和详细分析。
Docker支持： 通过Docker支持，轻松将Browsertime集成到你的CI/CD流程和容器化环境中。

安装

如果你是一名从事性能测量工具开发的工程师，或者只是想利用Browsertime的强大功能来满足你的Web性能需求，请按照以下安装和使用说明进行操作。

NodeJS

npm install -g browsertime
browsertime https://example.com

Docker

docker run --rm -v "$(pwd)":/browsertime sitespeedio/browsertime https://www.sitespeed.io/

使用方法

无论你的经验水平如何，Browsertime的设计都易于使用。以下是快速入门指南。

基本用法

browsertime https://www.example.com --browser chrome

此命令将使用Chrome测试https://www.example.com。

高级选项

Browsertime提供了多种高级选项，用于更详细的分析，例如指定运行次数、选择浏览器或设置自定义指标。以下是一些示例：

多次运行测试

browsertime -n 5 https://www.example.com

指定不同的浏览器

browsertime --browser firefox https://www.example.com

自定义指标

browsertime --script "return {'myMetric': window.myApp.customMetric}" https://www.example.com

要查看完整的选项列表，请运行<code>$ browsertime --help</code>，你可以看到配置选项。

网络连接

你可以限制连接速度，使连接变慢，从而更容易捕捉到性能退化。最好的方法是在Docker中设置网络桥接或使用我们的连接引擎Throttle。在文档中阅读更多关于如何操作的信息。

脚本中导航

如果你需要更复杂的测试场景，可以定义自己的（Selenium）测试脚本来进行测试。当你想测试已登录用户的页面、登录页面或向购物车添加商品时，请使用自己的测试脚本。

我们在文档中有一整节关于脚本编写的内容。

在移动设备上测试

Browsertime支持Android上的Chrome和Firefox：收集SpeedIndex、HAR和视频！

在开始之前，你需要安装adb并准备好你的手机。

如果你想设置连接，你需要使用类似gnirehtet的工具。在这里阅读更多信息。

<pre> $ browsertime --chrome.android.package com.android.chrome https://www.sitespeed.io --video --visualMetrics </pre>

使用WebPageReplay

我们的Docker容器现在包含WebPageReplay。

WebPageReplay允许你在本地重放页面（消除服务器延迟），使发现前端性能退化变得更容易。

它的工作原理如下：

启动脚本以记录模式启动WebPageReplay
然后启动Browsertime访问你选择的URL一次（以便记录）
关闭WebPageReplay
以重放模式启动WebPageReplay
Browsertime访问URL多次（你选择的次数）
关闭重放模式的WebPageReplay

你可以通过设置Docker环境变量来改变延迟。使用REPLAY来开启重放功能。

默认浏览器是Chrome：

docker run --cap-add=NET_ADMIN --rm -v "$(pwd)":/browsertime -e REPLAY=true -e LATENCY=100 sitespeedio/browsertime:20.0.0 https://en.wikipedia.org/wiki/Barack_Obama

使用Firefox：

docker run --cap-add=NET_ADMIN --rm -v "$(pwd)":/browsertime -e REPLAY=true -e LATENCY=100 sitespeedio/browsertime:20.0.0 -b firefox -n 11 --firefox.acceptInsecureCerts true https://en.wikipedia.org/wiki/Barack_Obama

在Android手机上使用Chrome。这只适用于Linux，因为你需要能够在Docker中挂载usb端口：

docker run --privileged -v /dev/bus/usb:/dev/bus/usb -e START_ADB_SERVER=true --cap-add=NET_ADMIN --rm -v "$(pwd)":/browsertime -e REPLAY=true -e LATENCY=100 sitespeedio/browsertime https://en.m.wikipedia.org/wiki/Barack_Obama --android --chrome.args ignore-certificate-errors-spki-list=PhrPvGIaAMmd29hj8BCZOq096yj7uMpRNHpn5PDxI6I= -n 11 --chrome.args user-data-dir=/data/tmp/chrome