webperf-snippets 1.4.0 → 1.5.0

package/snippets/Loading/Inline-CSS-Info-and-Size.js

@@ -146,6 +146,7 @@
 
   if (totalSize > criticalBudget) {
     issues.push({
+      code: "over-budget",
       type: "size",
       message: `Total inline CSS (${formatBytes(totalSize)}) exceeds 14 KB critical budget`,
       suggestion: "Move non-critical styles to external stylesheet",
@@ -154,6 +155,7 @@
 
   if (duplicates.length > 0) {
     issues.push({
+      code: "duplicate-blocks",
       type: "duplicate",
       message: `Found ${duplicates.length} duplicated style block(s)`,
       details: duplicates.map((d) => `Tags #${d.join(", #")} have identical content`),
@@ -164,6 +166,7 @@
   const largeBlocks = styles.filter((s) => s.size > 5 * 1024);
   if (largeBlocks.length > 0) {
     issues.push({
+      code: "large-blocks",
       type: "large",
       message: `${largeBlocks.length} style block(s) over 5 KB`,
       details: largeBlocks.map((s) => `Tag #${s.index}: ${formatBytes(s.size)}`),
@@ -174,6 +177,7 @@
   const bodyStyles = styles.filter((s) => !s.inHead);
   if (bodyStyles.length > 0) {
     issues.push({
+      code: "styles-in-body",
       type: "location",
       message: `${bodyStyles.length} style block(s) in <body>`,
       details: bodyStyles.map((s) => `Tag #${s.index}`),
@@ -231,6 +235,6 @@
       bodyStyleBlocks: styles.filter(s => !s.inHead).length,
     },
     items: styles.map(s => ({ index: s.index, sizeBytes: s.size, parent: s.parent, inHead: s.inHead, ruleCount: s.ruleCount, hasMediaQueries: s.hasMediaQueries, hasKeyframes: s.hasKeyframes })),
-    issues: issues.map(i => ({ severity: "warning", message: i.message })),
+    issues: issues.map(i => ({ code: i.code, severity: "warning", message: i.message })),
   };
 })();

package/snippets/Loading/Inline-Script-Info-and-Size.js

@@ -239,6 +239,7 @@
 
   if (parserBlockingInHead.length > 0) {
     issues.push({
+      code: "parser-blocking-in-head",
       type: "blocking",
       message: `${parserBlockingInHead.length} parser-blocking script(s) in <head>`,
       details: parserBlockingInHead.map(
@@ -251,6 +252,7 @@
   const largeScripts = executableScripts.filter((s) => s.size > 2 * 1024);
   if (largeScripts.length > 0) {
     issues.push({
+      code: "large-inline",
       type: "large",
       message: `${largeScripts.length} script(s) over 2 KB`,
       details: largeScripts.map((s) => `Script #${s.index}: ${formatBytes(s.size)}`),
@@ -260,6 +262,7 @@
 
   if (duplicates.length > 0) {
     issues.push({
+      code: "duplicate-scripts",
       type: "duplicate",
       message: `${duplicates.length} duplicated script(s) detected`,
       details: duplicates.map((d) => `Scripts #${d.join(", #")} have identical content`),
@@ -272,6 +275,7 @@
   );
   if (analyticsInHead.length > 0) {
     issues.push({
+      code: "analytics-in-head",
       type: "analytics",
       message: `${analyticsInHead.length} analytics script(s) blocking in <head>`,
       details: analyticsInHead.map((s) => `Script #${s.index}`),
@@ -345,6 +349,6 @@
       dataPayloadCount: scripts.filter((s) => s.isDataPayload).length,
     },
     items: rankedScripts.slice(0, MAX_ITEMS).map(s => ({ index: s.index, sizeBytes: s.size, category: s.category, inHead: s.inHead, isParserBlocking: s.isParserBlocking, isAnalytics: s.isAnalytics, isConfig: s.isConfig, isDataPayload: s.isDataPayload })),
-    issues: issues.map(i => ({ severity: i.type === "blocking" ? "error" : "warning", message: i.message })),
+    issues: issues.map(i => ({ code: i.code, severity: i.type === "blocking" ? "error" : "warning", message: i.message })),
   };
 })();

package/snippets/Loading/JS-Execution-Time-Breakdown.js

@@ -348,10 +348,10 @@
     },
     items: scripts.slice(0, 50).map(s => ({ shortName: s.shortName, isBlocking: s.isBlocking, downloadMs: Math.round(s.downloadDuration), estimatedParseMobileMs: s.estimatedParseMobile, transferBytes: s.transferSize, decodedBytes: s.decodedSize, corsRestricted: s.corsRestricted })),
     issues: [
-      ...(blocking.length > 0 ? [{ severity: "error", message: `${blocking.length} render-blocking script(s) delay HTML parsing` }] : []),
-      ...(hasHighParseTime ? [{ severity: "warning", message: `High estimated parse cost (~${Math.round(totalEstParse)}ms on mobile)` }] : []),
-      ...(splitCandidates.length > 0 ? [{ severity: "warning", message: `${splitCandidates.length} script(s) over 50KB decoded. Consider code splitting.` }] : []),
-      ...(poorCompression ? [{ severity: "warning", message: `Low compression ratio (${compressionRatio.toFixed(1)}x). Enable Brotli or gzip.` }] : []),
+      ...(blocking.length > 0 ? [{ code: "render-blocking", severity: "error", message: `${blocking.length} render-blocking script(s) delay HTML parsing` }] : []),
+      ...(hasHighParseTime ? [{ code: "high-parse-cost", severity: "warning", message: `High estimated parse cost (~${Math.round(totalEstParse)}ms on mobile)` }] : []),
+      ...(splitCandidates.length > 0 ? [{ code: "split-candidates", severity: "warning", message: `${splitCandidates.length} script(s) over 50KB decoded. Consider code splitting.` }] : []),
+      ...(poorCompression ? [{ code: "low-compression", severity: "warning", message: `Low compression ratio (${compressionRatio.toFixed(1)}x). Enable Brotli or gzip.` }] : []),
     ],
   };
 })();

package/snippets/Loading/Prefetch-Resource-Validation.js

@@ -28,7 +28,7 @@
       status: "ok",
       count: 0,
       items: [],
-      issues: [{ severity: "info", message: 'No prefetch hints on this page (rel="prefetch"), so there was nothing to validate.' }],
+      issues: [{ code: "no-prefetch", severity: "info", message: 'No prefetch hints on this page (rel="prefetch"), so there was nothing to validate.' }],
     };
   }
 
@@ -116,12 +116,14 @@
     // Check for missing or invalid 'as' attribute
     if (as === "unknown") {
       analysis.warnings.push({
+        code: "missing-as",
         type: "missing-as",
         severity: "warning",
         message: "Missing 'as' attribute - browser cannot apply correct MIME type matching",
       });
     } else if (!validAsValues.has(as)) {
       analysis.warnings.push({
+        code: "invalid-as",
         type: "invalid-as",
         severity: "warning",
         message: `Invalid 'as' value: "${as}" - should be one of: ${Array.from(validAsValues).join(", ")}`,
@@ -131,6 +133,7 @@
     // Check for duplicate prefetch
     if (seenUrls.has(normalizedUrl)) {
       analysis.warnings.push({
+        code: "duplicate-prefetch",
         type: "duplicate-prefetch",
         severity: "warning",
         message: "Duplicate prefetch - this URL is prefetched multiple times",
@@ -169,6 +172,7 @@
       if (isCurrentPageResource) {
         analysis.isCurrentPage = true;
         analysis.warnings.push({
+          code: "used-on-current-page",
           type: "wrong-hint",
           severity: "error",
           message: "Resource used on current page - should use preload instead",
@@ -179,6 +183,7 @@
       if (analysis.size > THRESHOLDS.largeFileSize) {
         const sizeMB = (analysis.size / (1024 * 1024)).toFixed(2);
         analysis.warnings.push({
+          code: "large-file",
           type: "large-file",
           severity: "warning",
           message: `Large file (${sizeMB}MB) - consider if prefetch is appropriate`,
@@ -203,6 +208,7 @@
 
       if (isInappropriate) {
         analysis.warnings.push({
+          code: "inappropriate-type",
           type: "inappropriate-type",
           severity: "warning",
           message: `Type "${as}" may not be suitable for prefetch: ${inappropriateReason}`,
@@ -229,6 +235,7 @@
   const countIssues = [];
   if (prefetchLinks.length > THRESHOLDS.maxCount) {
     countIssues.push({
+      code: "too-many-prefetches",
       type: "excessive-count",
       severity: "warning",
       message: `${prefetchLinks.length} prefetch hints found (recommended: <${THRESHOLDS.maxCount})`,
@@ -242,6 +249,7 @@
 
   if (totalSize > THRESHOLDS.totalSizeCritical) {
     countIssues.push({
+      code: "large-total-size",
       type: "excessive-size",
       severity: "error",
       message: `Total prefetch size: ${totalSizeMB}MB (critical threshold exceeded)`,
@@ -249,6 +257,7 @@
     });
   } else if (totalSize > THRESHOLDS.totalSizeWarning) {
     countIssues.push({
+      code: "large-total-size",
       type: "high-size",
       severity: "warning",
       message: `Total prefetch size: ${totalSizeMB}MB (warning threshold exceeded)`,
@@ -463,8 +472,8 @@
     },
     items: [...validPrefetch, ...issues].map(item => ({ href: item.shortUrl, as: item.as, sizeBytes: item.size, loaded: item.loaded, isCurrentPage: item.isCurrentPage || false })),
     issues: [
-      ...countIssues.map(i => ({ severity: i.severity === "error" ? "error" : "warning", message: i.message })),
-      ...issues.flatMap(item => item.warnings.filter(w => w.severity !== "info").map(w => ({ severity: w.severity, message: `${item.shortUrl}: ${w.message}` }))),
+      ...countIssues.map(i => ({ code: i.code, severity: i.severity === "error" ? "error" : "warning", message: i.message })),
+      ...issues.flatMap(item => item.warnings.filter(w => w.severity !== "info").map(w => ({ code: w.code, severity: w.severity, message: `${item.shortUrl}: ${w.message}`, target: item.href }))),
     ],
   };
 })();

package/snippets/Loading/Priority-Hints-Audit.js

@@ -77,8 +77,10 @@
     .filter((link) => link.getAttribute("fetchpriority") === "low")
     .forEach((link) => {
       issues.push({
+        code: "preload-low-priority",
         severity: "error",
         element: link,
+        url: link.href,
         resource: shortUrl(link),
         message: 'preload + fetchpriority="low" is contradictory',
         detail:
@@ -94,8 +96,10 @@
       const entry = getEntry(el);
       if (entry && entry.startTime < 500) {
         issues.push({
+          code: "low-priority-loaded-early",
           severity: "warning",
           element: el,
+          url: el.src || el.href,
           resource: shortUrl(el),
           message: `fetchpriority="low" but loaded at ${entry.startTime.toFixed(0)}ms`,
           detail:
@@ -112,8 +116,10 @@
       const entry = getEntry(el);
       if (entry && entry.startTime > 3000) {
         issues.push({
+          code: "high-priority-loaded-late",
           severity: "warning",
           element: el,
+          url: el.src || el.href,
           resource: shortUrl(el),
           message: `fetchpriority="high" but loaded at ${entry.startTime.toFixed(0)}ms`,
           detail:
@@ -127,8 +133,10 @@
   if (lcpCandidate && lcpCandidate.getAttribute("fetchpriority") !== "high") {
     const fp = lcpCandidate.getAttribute("fetchpriority");
     issues.push({
+      code: "lcp-no-fetchpriority",
       severity: "warning",
       element: lcpCandidate,
+      url: lcpCandidate.currentSrc || lcpCandidate.src,
       resource:
         (lcpCandidate.currentSrc || lcpCandidate.src).split("/").pop()?.split("?")[0] ||
         "LCP image",
@@ -340,8 +348,10 @@
       resource: (el.src || el.href || el.getAttribute("href") || "").split("/").pop()?.split("?")[0] || "",
     })),
     issues: issues.map(i => ({
+      code: i.code,
       severity: i.severity,
       message: i.fix ? `${i.message.replace(/\.$/, "")}. Fix: ${i.fix}` : i.message,
+      ...(i.url ? { target: i.url } : {}),
     })),
   };
 })();

package/snippets/Loading/Resource-Hints-Validation.js

@@ -538,9 +538,9 @@
       })),
     ].slice(0, 50),
     issues: [
-      ...(totalIssues > 0 ? [{ severity: "warning", message: `${totalIssues} unused hint(s) waste bandwidth` }] : []),
-      ...(missingHints.length > 0 ? [{ severity: "info", message: `${missingHints.length} domain(s) could benefit from connection hints` }] : []),
-      ...(redundantDomains.length > 0 ? [{ severity: "warning", message: `${redundantDomains.length} domain(s) have both preconnect and dns-prefetch (redundant)` }] : []),
+      ...(totalIssues > 0 ? [{ code: "unused-hints", severity: "warning", message: `${totalIssues} unused hint(s) waste bandwidth` }] : []),
+      ...(missingHints.length > 0 ? [{ code: "missing-connection-hints", severity: "info", message: `${missingHints.length} domain(s) could benefit from connection hints` }] : []),
+      ...(redundantDomains.length > 0 ? [{ code: "redundant-hints", severity: "warning", message: `${redundantDomains.length} domain(s) have both preconnect and dns-prefetch (redundant)` }] : []),
     ],
   };
 })();

package/snippets/Loading/Resource-Hints.js

@@ -93,6 +93,7 @@
       if (type.requiresAs && !hint.as) {
         issues.push({
           hint,
+          code: "preload-missing-as",
           issue: "Missing 'as' attribute (required for preload)",
           severity: "error",
           fix: `Add as="script|style|font|image|fetch"`,
@@ -102,6 +103,7 @@
       if (hint.as === "font" && !hint.crossorigin) {
         issues.push({
           hint,
+          code: "font-preload-no-crossorigin",
           issue: "Font preload without crossorigin (causes double fetch)",
           severity: "error",
           fix: 'Add crossorigin="anonymous"',
@@ -122,6 +124,7 @@
         if (corsResources.length > 0) {
           issues.push({
             hint,
+            code: "preconnect-no-crossorigin",
             issue: "Preconnect may need crossorigin for CORS resources",
             severity: "warning",
             fix: 'Consider adding crossorigin="anonymous"',
@@ -140,6 +143,7 @@
     if (!wasUsed) {
       issues.push({
         hint: preload,
+        code: "unused-preload",
         issue: "Preloaded resource not used within page load",
         severity: "warning",
         fix: "Remove unused preload or verify it's needed",
@@ -162,6 +166,7 @@
     if (!hasResources && pc.hostname) {
       issues.push({
         hint: pc,
+        code: "unused-preconnect",
         issue: `No resources loaded from ${pc.hostname}`,
         severity: "warning",
         fix: "Remove unused preconnect or verify it's needed for future resources",
@@ -173,6 +178,7 @@
   if (preloads.length > 6) {
     issues.push({
       hint: { rel: "preload", href: `${preloads.length} preloads` },
+      code: "too-many-preloads",
       issue: `Too many preloads (${preloads.length}) - they compete for bandwidth`,
       severity: "warning",
       fix: "Limit to 5-6 most critical resources",
@@ -424,6 +430,6 @@
       })),
     },
     items: rankedHints.slice(0, MAX_ITEMS).map(h => ({ rel: h.rel, href: h.shortHref, as: h.as, crossorigin: h.crossorigin, fetchpriority: h.fetchpriority })),
-    issues: issues.map(i => ({ severity: i.severity, message: `${i.hint.rel}: ${i.issue}. Fix: ${i.fix}` })),
+    issues: issues.map(i => ({ code: i.code, severity: i.severity, message: `${i.hint.rel}: ${i.issue}. Fix: ${i.fix}`, ...(i.hint.element ? { target: i.hint.href } : {}) })),
   };
 })();

package/snippets/Loading/SSR-Hydration-Data-Analysis.js

@@ -178,8 +178,10 @@
   detected.forEach((fw) => {
     if (fw.exceedsThreshold) {
       issuesData.push({
+        code: "large-hydration-data",
         severity: "warning",
         message: `${fw.name} hydration data (${Math.round(fw.size / 1024)} KB) exceeds ${Math.round(fw.threshold / 1024)} KB threshold`,
+        target: fw.name,
       });
     }
     console.log("");
@@ -296,13 +298,14 @@
             });
           });
           if (largeArrays.length > 0) {
-            issuesData.push({ severity: "warning", message: `pageProps has large arrays (${largeArrays.join(", ")}). Consider pagination.` });
+            issuesData.push({ code: "large-arrays", severity: "warning", message: `pageProps has large arrays (${largeArrays.join(", ")}). Consider pagination.` });
           }
           if (checkDepth(pageProps)) {
-            issuesData.push({ severity: "warning", message: "pageProps contains deeply nested data (more than 5 levels)." });
+            issuesData.push({ code: "deep-nesting", severity: "warning", message: "pageProps contains deeply nested data (more than 5 levels)." });
           }
           if (sensitiveKeys.length > 0) {
             issuesData.push({
+              code: "sensitive-keys",
               severity: "warning",
               message: `pageProps has keys that look sensitive (${sensitiveKeys.slice(0, 5).join(", ")}). Everything in pageProps is sent to every visitor.`,
             });

package/snippets/Loading/Script-Loading.js

@@ -226,6 +226,7 @@
 
   if (blockingInHead.length > 0) {
     issues.push({
+      code: "blocking-in-head",
       severity: "error",
       message: `${blockingInHead.length} blocking script(s) in <head>`,
       scripts: blockingInHead,
@@ -235,6 +236,7 @@
 
   if (thirdPartyBlocking.length > 0) {
     issues.push({
+      code: "third-party-blocking",
       severity: "error",
       message: `${thirdPartyBlocking.length} third-party blocking script(s)`,
       scripts: thirdPartyBlocking,
@@ -245,6 +247,7 @@
   const largeBlocking = blocking.filter((s) => s.size > 50 * 1024);
   if (largeBlocking.length > 0) {
     issues.push({
+      code: "large-blocking",
       severity: "warning",
       message: `${largeBlocking.length} large blocking script(s) (> 50 KB)`,
       scripts: largeBlocking,
@@ -262,6 +265,7 @@
 
   if (couldDefer.length > 0 && blocking.length > couldDefer.length) {
     issues.push({
+      code: "could-defer",
       severity: "info",
       message: `${blocking.length - couldDefer.length} blocking script(s) could potentially use defer`,
       fix: "Test with defer attribute to improve parsing performance",
@@ -391,9 +395,9 @@
       durationMs: Math.round(s.duration),
     })),
     issues: [
-      ...issues.map((i) => ({ severity: i.severity, message: i.message })),
+      ...issues.map((i) => ({ code: i.code, severity: i.severity, message: i.message })),
       ...(scripts.some((s) => !s.sizeKnown)
-        ? [{ severity: "info", message: `${scripts.filter((s) => !s.sizeKnown).length} script(s) have an unknown size (missing Timing-Allow-Origin); total size is a lower bound` }]
+        ? [{ code: "unknown-size", severity: "info", message: `${scripts.filter((s) => !s.sizeKnown).length} script(s) have an unknown size (missing Timing-Allow-Origin); total size is a lower bound` }]
         : []),
     ],
   };

package/snippets/Loading/Server-Timing-Early-Hints.js

@@ -83,6 +83,7 @@
   const issues = [];
   if (nav.serverTiming.length === 0) {
     issues.push({
+      code: "no-server-timing",
       severity: "info",
       message:
         "The document response sends no Server-Timing header. Add one, for example Server-Timing: db;dur=53, to expose backend timings in DevTools and in the Performance API.",
@@ -90,12 +91,14 @@
   }
   if (corsRestrictedCount > 0) {
     issues.push({
+      code: "timing-hidden",
       severity: "info",
       message: `${corsRestrictedCount} cross-origin resource(s) hide their timing because they lack Timing-Allow-Origin, so their Server-Timing cannot be read. Add Timing-Allow-Origin to expose it.`,
     });
   }
   if (!earlyHintsReceived) {
     issues.push({
+      code: "no-early-hints",
       severity: "info",
       message:
         "No 103 Early Hints response was observed for the document. If the server can send Link preload or preconnect headers before the final response, Early Hints lets the browser start those fetches earlier.",

package/snippets/Loading/Service-Worker-Analysis.js

@@ -22,7 +22,7 @@
       count: 0,
       details: {},
       items: [],
-      issues: [{ severity: "error", message: "Service Workers not supported in this browser" }],
+      issues: [{ code: "unsupported", severity: "error", message: "Service Workers not supported in this browser" }],
     };
   }
 
@@ -116,11 +116,12 @@
   const issues = [];
 
   if (registrations.length === 0) {
-    issues.push({ severity: "info", message: "No Service Workers registered" });
+    issues.push({ code: "no-service-worker", severity: "info", message: "No Service Workers registered" });
   }
 
   if (registrations.length > 0 && !controller) {
     issues.push({
+      code: "not-controlled",
       severity: "warning",
       message: "Page is not controlled by a Service Worker (hard reload or first visit). Do a normal reload.",
     });
@@ -129,25 +130,31 @@
   for (const item of items) {
     if (item.hasWaiting) {
       issues.push({
+        code: "update-pending",
         severity: "warning",
         message: `Service Worker update pending for ${item.scope}. Call skipWaiting() to activate the new version.`,
+        target: item.scope,
       });
     }
     if (item.navigationPreloadEnabled === false) {
       issues.push({
+        code: "navigation-preload-disabled",
         severity: "info",
         message: `Navigation Preload is disabled for ${item.scope}. Consider enabling it with registration.navigationPreload.enable().`,
+        target: item.scope,
       });
     }
   }
 
   if (swOverheadMs !== null && swOverheadMs > 100) {
     issues.push({
+      code: "slow-startup",
       severity: "error",
       message: `High SW startup time (${swOverheadMs}ms). Enable Navigation Preload to reduce overhead.`,
     });
   } else if (swOverheadMs !== null && swOverheadMs > 50) {
     issues.push({
+      code: "slow-startup",
       severity: "warning",
       message: `Moderate SW startup time (${swOverheadMs}ms)`,
     });
@@ -155,11 +162,13 @@
 
   if (cacheHitRate !== null && cacheHitRate < 50) {
     issues.push({
+      code: "low-cache-hit-rate",
       severity: "error",
       message: `Low SW cache hit rate (${cacheHitRate}%). Review the caching strategy.`,
     });
   } else if (cacheHitRate !== null && cacheHitRate < 80) {
     issues.push({
+      code: "low-cache-hit-rate",
       severity: "warning",
       message: `Moderate SW cache hit rate (${cacheHitRate}%). Review the caching strategy for more resources.`,
     });
@@ -167,6 +176,7 @@
 
   if (unknownSource.length > 0) {
     issues.push({
+      code: "unknown-source",
       severity: "info",
       message: `${unknownSource.length} intercepted resource(s) are cross-origin without Timing-Allow-Origin, so their source is unknown. The hit rate excludes them.`,
     });

package/snippets/Loading/Speculation-Rules-Inspector.js

@@ -39,6 +39,7 @@
         parsed = JSON.parse(script.textContent);
       } catch (e) {
         issues.push({
+          code: 'invalid-json',
           severity: 'error',
           message: `Speculation rules script #${index + 1} is not valid JSON (${e.message}). The browser ignores the whole script.`,
         });
@@ -68,12 +69,14 @@
           const isPrerender = action === 'prerender' || action === 'prerender_until_script';
           if (isPrerender && source === 'list' && (eagerness === 'immediate' || eagerness === 'eager') && urls.length > EAGER_PRERENDER_LIMIT) {
             issues.push({
+              code: 'eager-list-capped',
               severity: 'warning',
               message: `A ${action} rule lists ${urls.length} URLs with eagerness "${eagerness}". Chrome caps eager prerenders, so the extra URLs are not prerendered. Fix: list fewer URLs or use "moderate".`,
             });
           }
           if (isPrerender && source === 'document' && (eagerness === 'immediate' || eagerness === 'eager')) {
             issues.push({
+              code: 'eager-document-rule',
               severity: 'warning',
               message: `A document ${action} rule uses eagerness "${eagerness}", which prerenders matching links without a user signal and can waste bandwidth and CPU. Fix: use "moderate" or "conservative".`,
             });
@@ -83,15 +86,15 @@
     });
 
     if (scripts.length === 0) {
-      issues.push({ severity: 'info', message: 'No speculation rules found in the DOM. Rules delivered in the Speculation-Rules HTTP header are not readable from JavaScript.' });
+      issues.push({ code: 'no-rules', severity: 'info', message: 'No speculation rules found in the DOM. Rules delivered in the Speculation-Rules HTTP header are not readable from JavaScript.' });
     } else if (items.length === 0 && !issues.some((i) => i.severity === 'error')) {
-      issues.push({ severity: 'info', message: 'Speculation rules scripts were found but contain no prefetch or prerender rules.' });
+      issues.push({ code: 'no-prefetch-or-prerender', severity: 'info', message: 'Speculation rules scripts were found but contain no prefetch or prerender rules.' });
     }
     if (!supported && scripts.length > 0) {
-      issues.push({ severity: 'info', message: 'This browser does not support speculation rules, so the rules are ignored.' });
+      issues.push({ code: 'unsupported', severity: 'info', message: 'This browser does not support speculation rules, so the rules are ignored.' });
     }
     if (activationStart > 0) {
-      issues.push({ severity: 'info', message: `This page was prerendered and activated at ${activationStart}ms. Navigation timings are relative to activationStart.` });
+      issues.push({ code: 'prerendered', severity: 'info', message: `This page was prerendered and activated at ${activationStart}ms. Navigation timings are relative to activationStart.` });
     }
 
     return {

package/snippets/Loading/TTFB-Resources.js

@@ -168,7 +168,7 @@
       corsLimitedAnalysis: corsRestrictedCount > 0,
       details: { avgTtfbMs: null, maxTtfbMs: null, minTtfbMs: null, thirdPartyCount: 0, slowCount: 0, corsRestrictedCount },
       items: [],
-      issues: [{ severity: "info", message: "No resources with TTFB data available" }],
+      issues: [{ code: "no-resources", severity: "info", message: "No resources with TTFB data available" }],
     };
   }
   const ttfbVals = resourcesSync.map((r) => r.ttfbMs);

package/snippets/Loading/TTFB-Sub-Parts.js

@@ -129,6 +129,7 @@
     const slowestMs = Math.round(slowestSync.duration);
     const share = ttfbValueSync > 0 ? Math.round((slowestSync.duration / ttfbValueSync) * 100) : 0;
     issues.push({
+      code: "slow-ttfb",
       severity: rating === "poor" ? "error" : "warning",
       message: `TTFB is ${value} ms (${rating}); ${phaseLabels[slowestSync.key]} takes ${slowestMs} ms of it (${share}%). Fix: ${phaseFixes[slowestSync.key]}.`,
     });

package/snippets/Loading/Third-Party-Impact-by-Domain.js

@@ -187,30 +187,36 @@
   const issues = [];
   if (blocking.length > 0) {
     issues.push({
+      code: "render-blocking-domains",
       severity: "warning",
       message: `${blocking.length} third-party domain(s) serve render-blocking resources (${listDomains(blocking)}); load them async or defer, or self-host them`,
     });
   }
   heavy.slice(0, MAX_LISTED_DOMAINS).forEach((d) => {
     issues.push({
+      code: "heavy-domain",
       severity: "warning",
       message: `${d.domain} scripts take ${d.loafMs} ms of main-thread time in long animation frames (over ${LOAF_WARNING_MS} ms); defer, delay or remove them`,
+      target: d.domain,
     });
   });
   if (!renderBlockingSupported && all.length > 0) {
     issues.push({
+      code: "render-blocking-unsupported",
       severity: "info",
       message: "renderBlockingStatus is not supported in this browser (Chrome 107+), so which third-party domains block rendering is unknown; run the snippet in Chrome or Edge to check",
     });
   }
   if (loafUnattributed) {
     issues.push({
+      code: "loaf-unattributed",
       severity: "info",
       message: `${longFrames} long animation frame(s) took ${longFramesMs} ms, but no third-party script was attributed in them (Long Animation Frames only list scripts over 5 ms), so 0 ms per domain does not rule out third-party cost`,
     });
   }
   if (corsLimitedAnalysis) {
     issues.push({
+      code: "unknown-size",
       severity: "info",
       message: `${sizeUnknownCount} third-party request(s) without Timing-Allow-Origin report zero sizes, so the transfer size is a lower bound`,
     });

package/snippets/Loading/Validate-Preload-Async-Defer-Scripts.js

@@ -83,6 +83,7 @@
       } else {
         // Preload without matching script and not loaded - likely unused
         issues.push({
+          code: "orphan-preload",
           type: "orphan",
           severity: "warning",
           preload,
@@ -137,6 +138,7 @@
           });
         } else {
           issues.push({
+            code: "async-defer-preload",
             type: "async-defer-preload",
             severity: "error",
             preload,
@@ -156,6 +158,7 @@
       } else if (isModule) {
         // ES modules without async/defer behave like defer by default
         issues.push({
+          code: "module-preload",
           type: "module-preload",
           severity: "warning",
           preload,
@@ -413,8 +416,10 @@
     },
     items: Array.from(itemsByUrl.values()).slice(0, 50),
     issues: issues.map(i => ({
+      code: i.code,
       severity: i.severity,
       message: i.fix ? `${i.message.replace(/\.$/, "")}. Fix: ${i.fix}` : i.message,
+      target: i.url,
     })),
   };
 })();