browsertime 27.0.1 → 27.0.2

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Browsertime changelog (we do [semantic versioning](https://semver.org))
 
+## 27.0.2 - 2026-05-02
+
+### Fixed
+* SPA scripts no longer drop a HAR page when Chrome's soft-navigation `PerformanceObserver` entry doesn't fire. [#2438](https://github.com/sitespeedio/browsertime/pull/2438) gated HAR-page creation on Chrome detecting all three soft-navigation criteria (interaction + URL change + visible paint within a short window), but real SPAs like Grafana sometimes paint too late and Chrome never emits the entry — chrome-har then sees only `Network.*` events for that measurement and emits zero pages, breaking downstream per-iteration page indexing in sitespeed.io. When the measurement was started without a URL (`commands.measure.start(alias)` form) and no soft-nav entry was detected, fall back to a synthetic page anchored at the current `location.href` so each `measure.start` produces exactly one HAR page.
+
 ## 27.0.1 - 2026-05-02
 
 ### Fixed

package/lib/chrome/har.js

@@ -23,10 +23,17 @@ export async function getHar(
   const logs = await runner.getLogs(Type.PERFORMANCE);
   const messages = logs.map(entry => JSON.parse(entry.message).message);
 
-  // Inject a SoftNavigation.detected event so chrome-har renames the
-  // current HAR page with the soft navigation URL. The PerformanceObserver
-  // API is the only reliable source that confirms all three soft navigation
-  // criteria (user interaction + URL change + visible paint).
+  // Inject a SoftNavigation.detected event so chrome-har emits/renames a
+  // HAR page for this measurement. Chrome's PerformanceObserver
+  // soft-navigation entry is the trustworthy signal (user interaction +
+  // URL change + visible paint), but it doesn't always fire — Grafana and
+  // similar SPAs can defer their post-route paint past Chrome's window —
+  // so when this measurement was started without a URL (the
+  // `commands.measure.start(alias)` form, signalling "the next page is a
+  // soft-navigation I'm about to drive") we fall back to the current
+  // location.href. Without the fallback, chrome-har silently emits zero
+  // pages for that measurement and downstream consumers (sitespeed.io's
+  // per-iteration page indexing) drift out of alignment.
   try {
     const softNavEntries = await runner.runScript(
       `const supported = PerformanceObserver.supportedEntryTypes;
@@ -44,6 +51,17 @@ export async function getHar(
         method: 'SoftNavigation.detected',
         params: { url: entry.url, startTime: entry.startTime }
       });
+    } else if (!result.url) {
+      const fallbackUrl = await runner.runScript(
+        'return window.location.href;',
+        'GET_URL_FOR_HAR_FALLBACK'
+      );
+      if (fallbackUrl) {
+        messages.push({
+          method: 'SoftNavigation.detected',
+          params: { url: fallbackUrl, startTime: 0 }
+        });
+      }
     }
   } catch {
     // Soft navigations not supported, ignore

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "browsertime",
   "description": "Get performance metrics from your web page using Browsertime.",
-  "version": "27.0.1",
+  "version": "27.0.2",
   "bin": "./bin/browsertime.js",
   "type": "module",
   "types": "./types/scripting.d.ts",