Documentation v31

sitespeed.io logo

Sitespeed.io is the complete toolbox to test the web performance of your web site. Use it to monitor your performance or checkout how your competition is doing. You can see all the latest changes in the Changelog for the project.

Start #

  • Introduction - start here if you are new to the project or web performance testing.
  • Installation - install using npm, yarn or run our Docker containers.
  • Browsers - collect timings using real browsers. We support Firefox, Chrome, Chrome on Android and limited support for Safari on OS X and iOS.
  • Compare plugin - use Mann Whitney U or Wilcox statistical methods to know if you have a regression.
  • Configuration - there’s a lot of things you can do with sitespeed.io, lets checkout how!
  • Connectivity - set the connectivity to emulate real users network conditions.
  • Continuously run your tests - how to setup your test to continuously run your tests.
  • Docker - how to use our Docker containers.
  • F.A.Q and Best Practice - here we keep track of questions we get in Slack.
  • Metrics - definitions of all the metrics that is collected.
  • Performance Dashboard - monitor your web site and keep track of your metrics and performance.
  • Performance Leaderboard - compare your pages with your competition.
  • Scripting - test a user journey, test multiple URLs, test login, test adding items to the cart with scripting.
  • Web performance testing in practice - start to read this is if you are new into synthetics tests.

More details #

  • Alerts - send alerts (email/Slack/PagerDuty etc) when you get a performance regression.
  • Axe - run accessibility tests.
  • Continuous Integration - generate JUnit XML/TAP and use Jenkins, Circle CI, Gitlab CI, GitHub Actions, Grunt or the Gulp plugin.
  • Configure HTML output - change the default HTML output.
  • Configure Metrics - configure which metrics you want to send to Graphite/InfluxDB.
  • CPU - measure CPU metrics to see where your page spends the time.
  • CPU Benchmark - benchmark the CPU that runs your browser and tests.
  • Chrome User Experience Report - collect Chrome User Experience Report data in sitespeed.io.
  • Developers - start here when you want to do PRs or create a plugin.
  • Google Page Speed Insights - run Google Page Speed Insights (GPSI) from sitespeed.io.
  • Google Web Vitals - get Google Web Vitals using sitespeed.io and other tools.
  • Graphite - how to configure and store your metrics in Graphite (and using StatsD).
  • How to Write a Good Bug Report - if you write a good bug report, we can spend more time helping you fixing the problem instead of asking you questions
  • Lighthouse - run Lighthouse from sitespeed.io.
  • Matrix - send messages to your Matrix client.
  • Mobile phones - test using your mobile phone. Chrome on Android and Safari on iOS.
  • Performance Budget - make sure you are within your performance budget.
  • Plugins - list/disable/enable or create your own plugin.
  • Pre/post scripting - run Selenium scripts before/after you test a URL.
  • Setup S3 - how to setup S3 for your html result/videos and screenshots.
  • Setup GCS - how to setup Google Cloud storage (GCS) for your html result/videos and screenshots.
  • Single Page Application - how to test your single page application.
  • Sustainable web plugin - the sustainable web plugin helps you build a greener, more sustainable websites and applications.
  • Third party requests - keep track of those 3rd party scripts.
  • Video - all that you can do with the video and filmstrip.
  • WebPageReplay - WebPageReplay is proxy that first records your web site and then replay it locally. That can help you find performance regression in the front-end code easier: Latency/server timings are constant.
  • WebPageTest - drive WebPageTest and fetch metrics and graph them.