lighthouse 13.2.0 → 13.4.0-dev.20260625

package/core/audits/accessibility/heading-order.js

@@ -18,7 +18,7 @@ const UIStrings = {
   /** Title of an accessibility audit that checks if heading elements (<h1>, <h2>, etc) appear in numeric order and only ever increase in steps of 1. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
   failureTitle: 'Heading elements are not in a sequentially-descending order',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
-  description: 'Properly ordered headings that do not skip levels convey the semantic structure of the page, making it easier to navigate and understand when using assistive technologies. [Learn more about heading order](https://dequeuniversity.com/rules/axe/4.11/heading-order).',
+  description: 'Properly ordered headings that do not skip levels convey the semantic structure of the page, making it easier to navigate and understand when using assistive technologies. [Learn more about heading order](https://dequeuniversity.com/rules/axe/4.12/heading-order).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/html-has-lang.js

@@ -22,7 +22,7 @@ const UIStrings = {
       'that the page is in the default language that the user chose when setting up the ' +
       'screen reader. If the page isn\'t actually in the default language, then the screen ' +
       'reader might not announce the page\'s text correctly. ' +
-      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/html-has-lang).',
+      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/html-has-lang).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/html-lang-valid.js

@@ -21,7 +21,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
       'helps screen readers announce text properly. ' +
-      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/html-lang-valid).',
+      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/html-lang-valid).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/html-xml-lang-mismatch.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'If the webpage does not specify a consistent language, then the screen ' +
       'reader might not announce the page\'s text correctly. ' +
-      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/html-xml-lang-mismatch).',
+      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/html-xml-lang-mismatch).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/identical-links-same-purpose.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Links with the same destination should have the same description, to help users ' +
       'understand the link\'s purpose and decide whether to follow it. ' +
-      '[Learn more about identical links](https://dequeuniversity.com/rules/axe/4.11/identical-links-same-purpose).',
+      '[Learn more about identical links](https://dequeuniversity.com/rules/axe/4.12/identical-links-same-purpose).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/image-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Informative elements should aim for short, descriptive alternate text. ' +
       'Decorative elements can be ignored with an empty alt attribute. ' +
-      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.11/image-alt).',
+      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.12/image-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/image-redundant-alt.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Informative elements should aim for short, descriptive alternative text. ' +
       'Alternative text that is exactly the same as the text adjacent to the link or image is ' +
       'potentially confusing for screen reader users, because the text will be read twice. ' +
-      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.11/image-redundant-alt).',
+      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.12/image-redundant-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/input-button-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Adding discernable and accessible text to input buttons may help screen reader ' +
       'users understand the purpose of the input button. ' +
-      '[Learn more about input buttons](https://dequeuniversity.com/rules/axe/4.11/input-button-name).',
+      '[Learn more about input buttons](https://dequeuniversity.com/rules/axe/4.12/input-button-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/input-image-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'When an image is being used as an `<input>` button, providing alternative ' +
       'text can help screen reader users understand the purpose of the button. ' +
-      '[Learn about input image alt text](https://dequeuniversity.com/rules/axe/4.11/input-image-alt).',
+      '[Learn about input image alt text](https://dequeuniversity.com/rules/axe/4.12/input-image-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/label-content-name-mismatch.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Visible text labels that do not match the accessible name can result in a ' +
       'confusing experience for screen reader users. ' +
-      '[Learn more about accessible names](https://dequeuniversity.com/rules/axe/4.11/label-content-name-mismatch).',
+      '[Learn more about accessible names](https://dequeuniversity.com/rules/axe/4.12/label-content-name-mismatch).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/label.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Labels ensure that form controls are announced properly by assistive ' +
       'technologies, like screen readers. [Learn ' +
-      'more about form element labels](https://dequeuniversity.com/rules/axe/4.11/label).',
+      'more about form element labels](https://dequeuniversity.com/rules/axe/4.12/label).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/landmark-one-main.js

@@ -19,7 +19,7 @@ const UIStrings = {
   failureTitle: 'Document does not have a main landmark.',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'One main landmark helps screen reader users navigate a web page. ' +
-      '[Learn more about landmarks](https://dequeuniversity.com/rules/axe/4.11/landmark-one-main).',
+      '[Learn more about landmarks](https://dequeuniversity.com/rules/axe/4.12/landmark-one-main).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/link-in-text-block.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Low-contrast text is difficult or impossible for many users to read. Link text ' +
       'that is discernible improves the experience for users with low vision. ' +
-      '[Learn how to make links distinguishable](https://dequeuniversity.com/rules/axe/4.11/link-in-text-block).',
+      '[Learn how to make links distinguishable](https://dequeuniversity.com/rules/axe/4.12/link-in-text-block).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/link-name.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Link text (and alternate text for images, when used as links) that is ' +
       'discernible, unique, and focusable improves the navigation experience for ' +
       'screen reader users. ' +
-      '[Learn how to make links accessible](https://dequeuniversity.com/rules/axe/4.11/link-name).',
+      '[Learn how to make links accessible](https://dequeuniversity.com/rules/axe/4.12/link-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/list.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Screen readers have a specific way of announcing lists. Ensuring proper list ' +
       'structure aids screen reader output. ' +
-      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.11/list).',
+      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.12/list).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/listitem.js

@@ -21,7 +21,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Screen readers require list items (`<li>`) to be contained within a ' +
       'parent `<ul>`, `<ol>` or `<menu>` to be announced properly. ' +
-      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.11/listitem).',
+      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.12/listitem).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/meta-refresh.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Users do not expect a page to refresh automatically, and doing so will move ' +
       'focus back to the top of the page. This may create a frustrating or ' +
       'confusing experience. ' +
-      '[Learn more about the refresh meta tag](https://dequeuniversity.com/rules/axe/4.11/meta-refresh).',
+      '[Learn more about the refresh meta tag](https://dequeuniversity.com/rules/axe/4.12/meta-refresh).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/meta-viewport.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Disabling zooming is problematic for users with low vision who rely on ' +
       'screen magnification to properly see the contents of a web page. ' +
-      '[Learn more about the viewport meta tag](https://dequeuniversity.com/rules/axe/4.11/meta-viewport).',
+      '[Learn more about the viewport meta tag](https://dequeuniversity.com/rules/axe/4.12/meta-viewport).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/object-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Screen readers cannot translate non-text content. Adding alternate text to ' +
       '`<object>` elements helps screen readers convey meaning to users. ' +
-      '[Learn more about alt text for `object` elements](https://dequeuniversity.com/rules/axe/4.11/object-alt).',
+      '[Learn more about alt text for `object` elements](https://dequeuniversity.com/rules/axe/4.12/object-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/presentation-role-conflict.js

@@ -22,7 +22,7 @@ const UIStrings = {
       'or `role="presentation"` does not resolve to none or presentation. To ensure the ' +
       'element remains removed from the accessibility tree, you should not add any global ' +
       'ARIA attributes to the element or make it focusable. ' +
-      '[Learn more about presentation role conflict](https://dequeuniversity.com/rules/axe/4.11/presentation-role-conflict).',
+      '[Learn more about presentation role conflict](https://dequeuniversity.com/rules/axe/4.12/presentation-role-conflict).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/select-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Form elements without effective labels can create frustrating experiences ' +
       'for screen reader users. ' +
-      '[Learn more about the `select` element](https://dequeuniversity.com/rules/axe/4.11/select-name).',
+      '[Learn more about the `select` element](https://dequeuniversity.com/rules/axe/4.12/select-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/skip-link.js

@@ -19,7 +19,7 @@ const UIStrings = {
   failureTitle: 'Skip links are not focusable.',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Including a skip link can help users skip to the main content to save time. ' +
-      '[Learn more about skip links](https://dequeuniversity.com/rules/axe/4.11/skip-link).',
+      '[Learn more about skip links](https://dequeuniversity.com/rules/axe/4.12/skip-link).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/svg-img-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with \'Learn\' becomes link text to additional documentation. */
   description: 'Ensures SVG elements with an `img`, `graphics-document` or `graphics-symbol` ' +
       'role have an accessible text alternative. ' +
-      '[Learn more about SVG alt text](https://dequeuniversity.com/rules/axe/4.11/svg-img-alt).',
+      '[Learn more about SVG alt text](https://dequeuniversity.com/rules/axe/4.12/svg-img-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/tabindex.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'A value greater than 0 implies an explicit navigation ordering. ' +
       'Although technically valid, this often creates frustrating experiences ' +
-      'for users who rely on assistive technologies. [Learn more about the `tabindex` attribute](https://dequeuniversity.com/rules/axe/4.11/tabindex).',
+      'for users who rely on assistive technologies. [Learn more about the `tabindex` attribute](https://dequeuniversity.com/rules/axe/4.12/tabindex).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/table-duplicate-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'The summary attribute should describe the table structure, while `<caption>` ' +
       'should have the onscreen title. Accurate table mark-up helps users of screen readers. ' +
-      '[Learn more about summary and caption](https://dequeuniversity.com/rules/axe/4.11/table-duplicate-name).',
+      '[Learn more about summary and caption](https://dequeuniversity.com/rules/axe/4.12/table-duplicate-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/table-fake-caption.js

@@ -23,7 +23,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'that tables use the actual caption element instead of cells with the `[colspan]` ' +
       'attribute may improve the experience for screen reader users. ' +
-      '[Learn more about captions](https://dequeuniversity.com/rules/axe/4.11/table-fake-caption).',
+      '[Learn more about captions](https://dequeuniversity.com/rules/axe/4.12/table-fake-caption).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/target-size.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Touch targets with sufficient size and spacing help users who may have ' +
       'difficulty targeting small controls to activate the targets. ' +
-      '[Learn more about touch targets](https://dequeuniversity.com/rules/axe/4.11/target-size).',
+      '[Learn more about touch targets](https://dequeuniversity.com/rules/axe/4.12/target-size).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/td-has-header.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'that `<td>` elements in a large table (3 or more cells in width and height) have an ' +
       'associated table header may improve the experience for screen reader users. ' +
-      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.11/td-has-header).',
+      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.12/td-has-header).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/td-headers-attr.js

@@ -24,7 +24,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       '`<td>` cells using the `[headers]` attribute only refer to other cells in the same ' +
       'table may improve the experience for screen reader users. ' +
-      '[Learn more about the `headers` attribute](https://dequeuniversity.com/rules/axe/4.11/td-headers-attr).',
+      '[Learn more about the `headers` attribute](https://dequeuniversity.com/rules/axe/4.12/td-headers-attr).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/th-has-data-cells.js

@@ -23,7 +23,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'table headers always refer to some set of cells may improve the experience for screen ' +
       'reader users. ' +
-      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.11/th-has-data-cells).',
+      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.12/th-has-data-cells).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/valid-lang.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
       'on elements helps ensure that text is pronounced correctly by a screen reader. ' +
-      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/valid-lang).',
+      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/valid-lang).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/video-caption.js

@@ -21,7 +21,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'When a video provides a caption it is easier for deaf and hearing impaired ' +
       'users to access its information. ' +
-      '[Learn more about video captions](https://dequeuniversity.com/rules/axe/4.11/video-caption).',
+      '[Learn more about video captions](https://dequeuniversity.com/rules/axe/4.12/video-caption).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/agentic/agent-accessibility-tree.js

@@ -13,7 +13,7 @@ const UIStrings = {
   /** Title shown when one or more agent accessibility checks fail. */
   failureTitle: 'Accessibility tree is not well-formed',
   /** Description of a Lighthouse audit that tells the user *why* they need a well-formed accessibility tree. */
-  description: 'A well-formed accessibility tree helps AI agents to ' +
+  description: 'A well-formed [accessibility tree](http://goo.gle/lighthouse-agentic-a11y) helps AI agents to ' +
     'navigate and interact with the page.',
   /** Label of a table column that identifies the accessibility rule that failed. */
   columnRule: 'Failing Rule',

package/core/audits/agentic/llms-txt.d.ts

@@ -11,6 +11,7 @@ export namespace UIStrings {
     let failureTitle: string;
     let description: string;
     let displayValueHttpBadCode: string;
+    let explanationWithError: string;
     let explanation: string;
     let missingH1: string;
     let tooShort: string;

package/core/audits/agentic/llms-txt.js

@@ -11,20 +11,25 @@ const HTTP_CLIENT_ERROR_CODE_LOW = 400;
 const HTTP_SERVER_ERROR_CODE_LOW = 500;
 
 const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file is present and configured correctly. */
-  title: 'llms.txt is present',
-  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file is misconfigured. */
-  failureTitle: 'llms.txt is missing or incomplete',
-  /** Description of a Lighthouse audit that tells the user *why* they need to have a valid llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This is displayed after a user expands the section to see more. No character length limits. */
-  description: 'If your llms.txt file is malformed, large language models may not be able to ' +
-    'understand how you want your website to be crawled or used for training. A valid ' +
-    'llms.txt should be a Markdown file containing at least one H1 header. ' +
-    '[Learn more about llms.txt](https://llmstxt.org/).',
+  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file follows community recommendations. */
+  title: 'llms.txt follows recommendations',
+  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file does not follow community recommendations. */
+  failureTitle: 'llms.txt does not follow recommendations',
+  /** Description of a Lighthouse audit that tells the user *why* they should have an llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This is displayed after a user expands the section to see more. No character length limits. */
+  description: 'If your llms.txt file does not follow recommendations, ' +
+    'large language models may not be able to ' +
+    'understand how you want your website to be crawled or used for training. The ' +
+    '[llms.txt](https://llmstxt.org/) file should be a Markdown file containing at least one H1 header.',
   /**
    * @description Label for the audit identifying that the request failed with a specific HTTP status code.
    * @example {500} statusCode
    * */
   displayValueHttpBadCode: 'Failed with HTTP status {statusCode}',
+  /**
+   * @description Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the llms.txt file for the site.  Note: "llms.txt" is a canonical filename and should not be translated.
+   * @example {Timed out fetching resource} error
+   * */
+  explanationWithError: 'Fetch of llms.txt failed: {error}',
   /** Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the llms.txt file for the site.  Note: "llms.txt" is a canonical filename and should not be translated. */
   explanation: 'Fetch of llms.txt failed',
   /** Message indicating that the file is missing a required H1 header. */
@@ -59,8 +64,16 @@ class LlmsTxt extends Audit {
     const {
       status,
       content,
+      errorMessage,
     } = artifacts.LlmsTxt;
 
+    if (errorMessage) {
+      return {
+        score: 0,
+        explanation: str_(UIStrings.explanationWithError, {error: errorMessage}),
+      };
+    }
+
     if (!status) {
       return {
         score: 0,
@@ -84,7 +97,7 @@ class LlmsTxt extends Audit {
       throw new Error(`Status ${status} was valid, but content was null`);
     }
 
-    const hasH1 = /^#\s+.+/m.test(content);
+    const hasH1 = /^\s*#\s+.+/m.test(content);
     const hasLink = /\[.+\]\(.+\)/.test(content);
     const isTooShort = content.length < 50;
 

package/core/audits/baseline.js

@@ -4,8 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import data from 'web-features/data.json' with {type: 'json'};
-
+import data from '../lib/baseline/web-features-data.json' with {type: 'json'};
 import {Audit} from './audit.js';
 import metadata from '../lib/baseline/web-features-metadata.json' with {type: 'json'};
 import * as i18n from '../lib/i18n/i18n.js';
@@ -27,7 +26,6 @@ const UIStrings = {
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-const {features} = /** @type {any} */ (data);
 
 
 /** @typedef {LH.TraceEvent & {args: {feature: string, url?: string, lineNumber?: number, columnNumber?: number}}} DXFeatureEvent */
@@ -90,21 +88,21 @@ class Baseline extends Audit {
         continue;
       }
 
-      const featureData = features[feature.featureId];
-
-      if (!featureData || !('status' in featureData)) {
-        continue;
-      }
+      const featureId = feature.featureId;
 
       let displayStatus = 'Limited Availability';
       let baselineTier = 'limited';
 
-      if (featureData.status.baseline === 'high') {
-        displayStatus = `Widely Available (${featureData.status.baseline_low_date})`;
+      if (featureId in data.high) {
+        const highData = /** @type {Record<string, string>} */ (data.high);
+        displayStatus = `Widely Available (${highData[featureId]})`;
         baselineTier = 'high';
-      } else if (featureData.status.baseline === 'low') {
-        displayStatus = `Newly Available (${featureData.status.baseline_low_date})`;
+      } else if (featureId in data.low) {
+        const lowData = /** @type {Record<string, string>} */ (data.low);
+        displayStatus = `Newly Available (${lowData[featureId]})`;
         baselineTier = 'low';
+      } else if (!data.limited.includes(featureId)) {
+        continue;
       }
 
       baselineStatus.push({

package/core/audits/dobetterweb/geolocation-on-start.js

@@ -21,7 +21,8 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user why they should not ask for geolocation permissions on load. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Users are mistrustful of or confused by sites that request their ' +
     'location without context. Consider tying the request to a user action instead. ' +
-    '[Learn more about the geolocation permission](https://developer.chrome.com/docs/lighthouse/best-practices/geolocation-on-start/).',
+    '[Learn more about the geolocation permission](https://developer.chrome.com/docs/lighthouse/best-practices/geolocation-on-start/). ' +
+    'Also consider using the [`<geolocation>` element](https://developer.chrome.com/blog/geolocation-html-element).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/network-requests.js

@@ -70,6 +70,8 @@ class NetworkRequests extends Audit {
         url: UrlUtils.elideDataURI(record.url),
         sessionTargetType: record.sessionTargetType,
         protocol: record.protocol,
+        cache: record.fromDiskCache ? 'disk' :
+               record.fromMemoryCache ? 'memory' : record.fromPrefetchCache ? 'prefetch' : 'none',
         rendererStartTime: normalizeTime(record.rendererStartTime),
         networkRequestTime: normalizeTime(record.networkRequestTime),
         networkEndTime: normalizeTime(record.networkEndTime),

package/core/audits/seo/canonical.js

@@ -5,7 +5,6 @@
  */
 
 import {Audit} from '../audit.js';
-import UrlUtils from '../../lib/url-utils.js';
 import {MainResource} from '../../computed/main-resource.js';
 import * as i18n from '../../lib/i18n/i18n.js';
 
@@ -90,12 +89,25 @@ class Canonical extends Audit {
         // Links that don't have an href aren't canonical references for SEO, skip them
         if (!link.hrefRaw) continue;
 
-        // Links that had an hrefRaw but didn't have a valid href were invalid, flag them
-        if (!link.href) invalidCanonicalLink = link;
-        // Links that had a valid href but didn't have a valid hrefRaw must have been relatively resolved, flag them
-        else if (!UrlUtils.isValid(link.hrefRaw)) relativeCanonicallink = link;
-        // Otherwise, it was a valid canonical URL
-        else uniqueCanonicalURLs.add(link.href);
+        // Links that don't have an href are invalid, flag them
+        if (!link.href) {
+          invalidCanonicalLink = link;
+          continue;
+        }
+
+        if (URL.parse(link.hrefRaw, 'https://example.com') === null) {
+          // Links that are syntactically INVALID with a base, flag them
+          invalidCanonicalLink = link;
+        } else {
+          // Links that are syntactically VALID with a base:
+          if (URL.parse(link.hrefRaw) === null) {
+            // Links that are INVALID without a base must be relative, flag them
+            relativeCanonicallink = link;
+          } else {
+            // Links that are valid without a base are absolute
+            uniqueCanonicalURLs.add(link.href);
+          }
+        }
       } else if (link.rel === 'alternate') {
         if (link.href && link.hreflang) hreflangURLs.add(link.href);
       }

package/core/audits/seo/robots-txt.d.ts

@@ -12,6 +12,7 @@ export namespace UIStrings {
     let description: string;
     let displayValueHttpBadCode: string;
     let displayValueValidationError: string;
+    let explanationWithError: string;
     let explanation: string;
 }
 import { Audit } from '../audit.js';

package/core/audits/seo/robots-txt.js

@@ -50,8 +50,13 @@ const UIStrings = {
     =1 {1 error found}
     other {# errors found}
     }`,
+  /**
+   * @description Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the robots.txt file for the site.  Note: "robots.txt" is a canonical filename and should not be translated.
+   * @example {Timed out fetching resource} error
+   * */
+  explanationWithError: 'Fetch of robots.txt failed: {error}',
   /** Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the robots.txt file for the site.  Note: "robots.txt" is a canonical filename and should not be translated. */
-  explanation: 'Lighthouse was unable to download a robots.txt file',
+  explanation: 'Fetch of robots.txt failed',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
@@ -200,24 +205,33 @@ class RobotsTxt extends Audit {
     const {
       status,
       content,
+      errorMessage,
     } = artifacts.RobotsTxt;
 
-    if (!status) {
+    // Do specific error messages first.
+    if (status && status >= HTTP_SERVER_ERROR_CODE_LOW) {
       return {
         score: 0,
-        explanation: str_(UIStrings.explanation),
+        displayValue: str_(UIStrings.displayValueHttpBadCode, {statusCode: status}),
+      };
+    } else if (status && status >= HTTP_CLIENT_ERROR_CODE_LOW || content === '') {
+      return {
+        score: 1,
+        notApplicable: true,
       };
     }
 
-    if (status >= HTTP_SERVER_ERROR_CODE_LOW) {
+    if (errorMessage) {
       return {
         score: 0,
-        displayValue: str_(UIStrings.displayValueHttpBadCode, {statusCode: status}),
+        explanation: str_(UIStrings.explanationWithError, {error: errorMessage}),
       };
-    } else if (status >= HTTP_CLIENT_ERROR_CODE_LOW || content === '') {
+    }
+
+    if (!status) {
       return {
-        score: 1,
-        notApplicable: true,
+        score: 0,
+        explanation: str_(UIStrings.explanation),
       };
     }