Run browser tests with Selenium in CI

.github/workflows/browser-tests.yml

@@ -0,0 +1,23 @@
+name: Browser tests
+on:
+  push:
+    branches:
+    - main
+  pull_request:
+    branches:
+    - main
+jobs:
+  selenium:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+    - name: Use Node.js
+      uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6
+      with:
+        node-version: '26.x'
+    - name: Install dependencies
+      run: npm ci
+    - name: Build
+      run: npm run build
+    - name: Selenium tests
+      run: npm run test:e2e

README.md

@@ -123,12 +123,15 @@ Run the dev server:
 npm run develop
 ```
 
-Lint and run the tests (CI runs both on every PR):
+Lint and run the tests (CI runs all of them on every PR):
 ```
 npm run lint
 npm test
+npm run build && npm run test:e2e
 ```
 
+The browser tests use [Selenium](https://www.selenium.dev/documentation/webdriver/) and Chrome. Selenium Manager finds or downloads Chrome and chromedriver. To use a local install instead, set `CHROME_BIN` and `CHROMEDRIVER`.
+
 Send us a PR / create an issue. If you have a big change coming up, please discuss it with us in an issue first.
 
 ## Deploy your own version

eslint.config.js

@@ -38,5 +38,12 @@ export default [
     languageOptions: {
       globals: { ...globals.node }
     }
+  },
+  {
+    // Functions passed to executeScript run in the browser
+    files: ['test/e2e/**/*.js'],
+    languageOptions: {
+      globals: { ...globals.browser }
+    }
   }
 ];

package.json

@@ -37,13 +37,15 @@
     "@eslint/js": "^10.0.1",
     "eslint": "^10.13.0",
     "globals": "^17.13.0",
+    "selenium-webdriver": "^4.51.0",
     "vite": "^6.0.0"
   },
   "scripts": {
     "build": "vite build",
     "develop": "vite",
     "lint": "eslint . --max-warnings 0",
     "preview": "vite preview",
-    "test": "node --test 'test/*.test.js'"
+    "test": "node --test 'test/*.test.js'",
+    "test:e2e": "node --test 'test/e2e/*.test.js'"
   }
 }