Add WP Rocket settings no-broken-links check

package.json

@@ -29,6 +29,7 @@
     "test:cdn": "$npm_package_config_testCommand --tags @cdn",
     "test:performancehints": "$npm_package_config_testCommand --tags @performancehints",
     "test:cloudflare-compatibility": "$npm_package_config_testCommand --tags @cloudflare-compatibility",
+    "test:brokenlinks": "$npm_package_config_testCommand --tags @brokenlinks",
     "healthcheck": "ts-node healthcheck.ts",
     "push-report": "ts-node report.ts",
     "wp-env": "wp-env",

src/features/broken-links.feature

@@ -0,0 +1,8 @@
+@setup @smoke @brokenlinks
+Feature: Broken links in WP Rocket settings UI
+
+  Scenario: WP Rocket settings links are not broken
+    Given I am logged in
+    And plugin is installed 'new_release'
+    And plugin is activated
+    Then WP Rocket settings links are not broken

src/support/steps/broken-links.ts

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview
+ * This module contains Cucumber step definitions for validating links in WP Rocket settings UI.
+ *
+ * @requires {@link ../../common/custom-world}
+ * @requires {@link @playwright/test}
+ * @requires {@link @cucumber/cucumber}
+ */
+import { expect } from '@playwright/test';
+import { Then } from '@cucumber/cucumber';
+import { ICustomWorld } from '../../common/custom-world';
+
+/**
+ * Executes the step to verify that WP Rocket settings links are not broken.
+ *
+ * @function
+ * @async
+ * @param {ICustomWorld} this - The Cucumber world context for the current scenario.
+ * @return {Promise<void>} - A Promise that resolves when the check is completed.
+ */
+Then('WP Rocket settings links are not broken', async function (this: ICustomWorld) {
+    const hrefs = new Set<string>();
+
+    // Visit WP Rocket settings.
+    await this.utils.visitPage('wp-admin/options-general.php?page=wprocket');
+
+    const collectLinks = async (): Promise<void> => {
+        const links = await this.page.$$eval('#wpbody-content a[href]', (elements) =>
+            elements
+                .map((element) => element.getAttribute('href'))
+                .filter(Boolean)
+        );
+
+        for (const href of links) {
+            hrefs.add(href as string);
+        }
+    };
+
+    // Collect links from the base settings page first.
+    await collectLinks();
+
+    // Collect tab links from within the WP Rocket settings content.
+    const tabHrefs = await this.page.$$eval('#wpbody-content a[href*="page=wprocket#"]', (links) =>
+        links
+            .map((link) => link.getAttribute('href'))
+            .filter(Boolean)
+    );
+
+    const tabUrls = Array.from(new Set(tabHrefs)).map((href) => {
+        return new URL(href as string, this.page.url()).toString();
+    });
+
+    for (const tabUrl of tabUrls) {
+        await this.page.goto(tabUrl);
+        await this.page.waitForLoadState('load');
+        await collectLinks();
+    }
+
+    const normalizedUrls = new Set<string>();
+    const skipProtocols = ['mailto:', 'tel:', 'javascript:'];
+
+    for (const href of hrefs) {
+        const lowerHref = href.toLowerCase();
+        if (lowerHref.startsWith('#')) {
+            continue;
+        }
+
+        if (skipProtocols.some((protocol) => lowerHref.startsWith(protocol))) {
+            continue;
+        }
+
+        try {
+            const url = new URL(href, this.page.url());
+            if (!['http:', 'https:'].includes(url.protocol)) {
+                continue;
+            }
+
+            if (url.pathname.endsWith('/wp-admin/admin-post.php')) {
+                // Avoid triggering admin-post actions.
+                continue;
+            }
+
+            url.hash = '';
+            normalizedUrls.add(url.toString());
+        } catch {
+            continue;
+        }
+    }
+
+    for (const url of normalizedUrls) {
+        try {
+            const response = await this.page.request.get(url, { maxRedirects: 5, timeout: 30000 });
+            expect(response.status(), `Expected ${url} not to return 404`).not.toBe(404);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Network error while requesting ${url}: ${message}`);
+        }
+    }
+});