Tests: migrate test runner to jquery-test-runner

Closes jquerygh-5604

Author: timmywil

.github/workflows/browserstack-dispatch.yml

@@ -59,4 +59,6 @@ jobs:
         run: npm run pretest
 
       - name: Run tests
-        run: npm run test:unit -- -v --browserstack ${{ inputs.browser }} -m ${{ inputs.module }}
+        run: npm run test:unit -- \
+          -v --browserstack ${{ inputs.browser }} \
+          -f module=${{ inputs.module }}

.github/workflows/browserstack.yml

@@ -12,7 +12,7 @@ jobs:
     env:
       BROWSERSTACK_USERNAME: ${{ secrets.BROWSERSTACK_USERNAME }}
       BROWSERSTACK_ACCESS_KEY: ${{ secrets.BROWSERSTACK_ACCESS_KEY }}
-      NODE_VERSION: 20.x
+      NODE_VERSION: 22.x
     name: ${{ matrix.BROWSER }}
     concurrency:
       group: ${{ github.workflow }}-${{ matrix.BROWSER }}
@@ -61,4 +61,7 @@ jobs:
         run: npm run pretest
 
       - name: Run tests
-        run: npm run test:unit -- -v --browserstack "${{ matrix.BROWSER }}" --run-id ${{ github.run_id }} --isolate --retries 3 --hard-retries 1
+        run: |
+          npm run test:unit -- -v -c jtr-isolate.yml \
+            --browserstack "${{ matrix.BROWSER }}" \
+            --run-id ${{ github.run_id }}

.github/workflows/filestash.yml

@@ -16,7 +16,7 @@ jobs:
     if: ${{ github.repository == 'jquery/jquery' }}
     environment: filestash
     env:
-      NODE_VERSION: 20.x
+      NODE_VERSION: 22.x
     steps:
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

.github/workflows/node.js.yml

@@ -20,28 +20,28 @@ jobs:
         NPM_SCRIPT: ["test:browserless"]
         include:
           - NAME: "Node"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "lint"
           - NAME: "Chrome/Firefox"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:browser"
           - NAME: "Chrome"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:slim"
           - NAME: "Chrome"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:no-deprecated"
           - NAME: "Chrome"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:selector-native"
           - NAME: "Chrome"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:esm"
           - NAME: "Firefox ESR (new)"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:firefox"
           - NAME: "Firefox ESR (old)"
-            NODE_VERSION: "20.x"
+            NODE_VERSION: "22.x"
             NPM_SCRIPT: "test:firefox"
     steps:
       - name: Checkout
@@ -80,7 +80,7 @@ jobs:
       - name: Install dependencies
         run: npm install
 
-      - name: Build All for Linting
+      - name: Build all for linting
         run: npm run build:all
         if: contains(matrix.NPM_SCRIPT, 'lint')
 
@@ -90,7 +90,7 @@ jobs:
   ie:
     runs-on: windows-latest
     env:
-      NODE_VERSION: 20.x
+      NODE_VERSION: 22.x
     name: test:ie - IE
     steps:
       - name: Checkout
@@ -118,7 +118,7 @@ jobs:
   safari:
     runs-on: macos-latest
     env:
-      NODE_VERSION: 20.x
+      NODE_VERSION: 22.x
     name: test:safari - Safari
     steps:
       - name: Checkout

.github/workflows/verify-release.yml

@@ -19,7 +19,7 @@ jobs:
     # skip on forks
     if: ${{ github.repository == 'jquery/jquery' }}
     env:
-      NODE_VERSION: 20.x
+      NODE_VERSION: 22.x
     steps:
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

CONTRIBUTING.md

@@ -131,10 +131,10 @@ This will only run the "css" module tests. This will significantly speed up your
 
 #### Change the test server port
 
-The default port for the test server is 3000. You can change the port by setting the `PORT` environment variable.
+The default port for the test server is 3000. You can change the port by setting the `--port` option.
 
 ```bash
-$ PORT=3001 npm run test:server
+$ npm run test:server -- --port 8000
 ```
 
 #### Loading changes on the test page
@@ -165,14 +165,34 @@ Make sure jQuery is built (`npm run build:all`) and run the tests:
 $ npm run test:unit
 ```
 
-This will run each module in its own browser instance and report the results in the terminal.
+This will run all tests and report the results in the terminal.
 
 View the full help for the test suite for more info on running the tests from the command line:
 
 ```bash
 $ npm run test:unit -- --help
 ```
 
+#### Running a single module
+
+All test modules run by default. Run a single module by specifying the module in a "flag":
+
+```bash
+$ npm run test:unit -- --flag module=css
+```
+
+Or, run multiple modules with multiple flags (`-f` is shorthand for `--flag`):
+
+```bash
+$ npm run test:unit -- -f module=css -f module=effects
+```
+
+Anything passed to the `--flag` option is passed as query parameters on the QUnit test page. For instance, run tests with unminified code with the `dev` flag:
+
+```bash
+$ npm run test:unit -- -f dev
+```
+
 ### Repo organization
 
 The jQuery source is organized with ECMAScript modules and then compiled into one file at build time.

jtr-isolate.yml

@@ -0,0 +1,30 @@
+version: 1
+
+base-url: /test/
+
+runs:
+  module:
+    - basic
+    - ajax
+    - animation
+    - attributes
+    - callbacks
+    - core
+    - css
+    - data
+    - deferred
+    - deprecated
+    - dimensions
+    - effects
+    - event
+    - manipulation
+    - offset
+    - queue
+    - selector
+    - serialize
+    - support
+    - traversing
+    - tween
+
+retries: 3
+hard-retries: 1