Tests: migrate from karma (deprecated) to web-test-runner

.eslintrc.json

@@ -73,10 +73,16 @@
             "ignoreTemplateLiterals": true,
             "ignoreRegExpLiterals": true
         }],
-        "no-restricted-imports": ["error", {
-            "name": "openpgp",
-            "message": "Please import from 'lib/openpgp' instead."
-        }],
+        "no-restricted-imports": ["error",
+            {
+                "name": "openpgp",
+                "message": "Please import from 'lib/openpgp' instead."
+            },
+            {
+                "name": "chai",
+                "message": "Please import from 'test/setupMocha' instead."
+            }
+        ],
         "no-multiple-empty-lines": ["error"],
         "no-trailing-spaces": ["error"],
         "eol-last": ["error"],

.github/workflows/tests.yml

@@ -18,6 +18,8 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
+        with:
+          node-version: '>=22' # fn.globSync support needed for wtr setup
 
       - name: Install dependencies
         run: npm ci
@@ -30,10 +32,13 @@ jobs:
         run: npx playwright install --with-deps chromium
 
       - name: Install Firefox
-        run: npx playwright install --with-deps firefox
+        run: npx playwright install --with-deps firefox-beta
 
-      - name: Install Webkit
+      # do not install webkit on ubuntu, since the X25519 WebCrypto implementation
+      # has issues, see https://github.com/openpgpjs/openpgpjs/pull/1829 .
+      - if: ${{ matrix.runner  == 'macos-latest' }}
+        name: Install Webkit
         run: npx playwright install --with-deps webkit
 
       - name: Run tests
-        run: npm test
+        run: npm run test:ci

README.md

@@ -129,7 +129,11 @@ const sessionKey = await decryptSessionKey({
 
 ## Testing
 Headless Chrome (or Chromium), Firefox and Webkit are used for the tests.
-To install any missing browsers automatically, you can run `npx playwright install --with-deps <chromium|firefox|webkit>`. Alternatively, you can install them manually as you normally would on your platform.
-If you'd like to test on a subset of browsers, use e.g. `npm test -- --browsers ChromeHeadless,FirefoxHeadless`.
+To install any missing browsers automatically, you can run `npx playwright install --with-deps <chromium|firefox|webkit|firefox-beta>`. Alternatively, you can install them manually as you normally would on your platform.
 
+The available test commands are:
+
+- `npm run test`: all browsers are tested in headless mode.
+- `npm run test:ci`: similar to `test`, but beta browser versions are used if the vendor provides them; also, Webkit is skipped if not installed.
+- `npm run test:debug`: opens up a browser instance in your default browser to allow debugging the tests live