MCPcopy Index your code
hub / github.com/zeman/perfmap

github.com/zeman/perfmap @main sqlite

repository ↗ · DeepWiki ↗
5 symbols 10 edges 2 files 0 documented · 0%
README

PerfMap: front-end performance heatmap

A bookmarklet and Chrome extension to create a front-end performance heatmap of resources loaded in the browser using the Resource Timing API. A browser with support for the Resource Timing API is required.

Bookmarklet

Just add the bookmarklet below to your bookmarks bar.

javascript:(function(){var el=document.createElement('script');el.src='https://zeman.github.io/perfmap/perfmap.js';document.body.appendChild(el);})();

Chrome Extension

Or grab the Chrome extension wrapped by Umar Hansa

Usage

Wait for a page to fully load and then click the bookmarklet or extension icon to overlay a performance heatmap.

The heatmap colours and the first ms value indicate at what point in the page load the image finished loading. It's a good indicator of user experience... "It took 3450ms before the user saw this image." The second value in brackets is the time it took the browser to load that specific image.

The legend attached to the bottom of the page shows timings for the full page load and hovering over a coloured area on the heatmap will move the timeline indicator to show you when that image was fully loaded.

Example

Example Heatmap

Background

Conceived as part of a set of data visualization experiments which re-imagined the front-end performance waterfall chart by Mark Zeman from SpeedCurve presented at Velocity New York 2014.

Works In

  • Chrome
  • Firefox - Can be enabled in Firefox by putting "about:config" in as a url and then setting "dom.enable_resource_timing" to true.

To Do

  • Deal with fixed position elements (calling all front-end ninjas, send me your thoughts on how best to do this)
  • Crawl iframe images
  • Hover state with more detail on the timings of an individual resource
  • User timing, pull out and highlight any elements with associated user timing events
  • Expand top nav to show full waterfall chart of all resources. Combine with Andy's waterfall bookmarklet?

Change Log

  • 2014-10-06 First push of rough proof of concept
  • 2014-10-07 Added background-image support
  • 2014-10-08 Added interactive legend with page level timing and timeline head on overlay hover
  • 2014-10-12 Ignore elements with visibility:hidden, check for viewport sized images and treat like a body image, design tweaks
  • 2014-10-17 Rolled in Umar's Chrome extension

Thanks

Big thanks to Steve Souders who was inspired enough to whip up the intial code structure while simultaneously participating at WebPerfDays NY. Clever cookie!

Core symbols most depended-on inside this repo

findImages
called by 1
perfmap.js
getPositionOfMarker
called by 1
perfmap.js
placeMarker
called by 1
perfmap.js
heatmap
called by 1
perfmap.js
getCumulativeOffset
called by 1
perfmap.js

Shape

Function 5

Languages

TypeScript100%

Modules by API surface

perfmap.js5 symbols

For agents

$ claude mcp add perfmap \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact