test markup
13 |
14 |
15 |
--------------------------------------------------------------------------------
/demos/bundlers/test/require-default.cjs:
--------------------------------------------------------------------------------
1 | const QUnit = require('qunit');
2 | const { add } = require('./src.js');
3 |
4 | (globalThis.TEST_OBJECTS || (globalThis.TEST_OBJECTS = {})).require_default = QUnit;
5 |
6 | QUnit.hello_require_default = QUnit.assert.hello_require_default = 'require-default';
7 |
8 | QUnit.test('require-default', function (assert) {
9 | assert.equal(add(2, 3), 5);
10 | });
11 |
--------------------------------------------------------------------------------
/src/core/reporters.js:
--------------------------------------------------------------------------------
1 | import ConsoleReporter from './reporters/ConsoleReporter.js';
2 | import PerfReporter from './reporters/PerfReporter.js';
3 | import TapReporter from './reporters/TapReporter.js';
4 | import HtmlReporter from './reporters/HtmlReporter.js';
5 |
6 | export default {
7 | console: ConsoleReporter,
8 | perf: PerfReporter,
9 | tap: TapReporter,
10 | html: HtmlReporter
11 | };
12 |
--------------------------------------------------------------------------------
/test/browser-runner/window-onerror.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | test markup
13 |
14 |
15 |
--------------------------------------------------------------------------------
/test/cli/fixtures/config-notrycatch-test-rejection.js:
--------------------------------------------------------------------------------
1 | 'use strict';
2 |
3 | process.on('unhandledRejection', (reason) => {
4 | console.log('FOUND Unhandled Rejection:', reason);
5 | });
6 |
7 | QUnit.config.testTimeout = 1000;
8 | QUnit.config.notrycatch = true;
9 |
10 | QUnit.module('example', function () {
11 | QUnit.test('returns a rejected promise', function () {
12 | return Promise.reject('bad things happen');
13 | });
14 | });
15 |
--------------------------------------------------------------------------------
/test/cli/fixtures/memory-leak-module-closure-unfiltered.tap.txt:
--------------------------------------------------------------------------------
1 | # name: memory leak module-closure unfiltered
2 | # command: ["node", "--expose-gc", "../../../bin/qunit.js", "memory-leak-module-closure.js"]
3 |
4 | TAP version 13
5 | ok 1 module-closure > example test
6 | ok 2 module-closure > example child module > example child module test
7 | ok 3 module-closure check > memory release
8 | 1..3
9 | # pass 3
10 | # skip 0
11 | # todo 0
12 | # fail 0
--------------------------------------------------------------------------------
/test/only-each.js:
--------------------------------------------------------------------------------
1 | QUnit.module.only('test.each.only', function () {
2 | QUnit.test("don't run", function (assert) { assert.true(false); });
3 | QUnit.test.only.each('test.each.only', [[1, 2, 3], [1, 1, 2]], function (assert, data) {
4 | assert.strictEqual(data[0] + data[1], data[2]);
5 | });
6 | QUnit.test.only.each('test.each.only 1D', [1, [], 'some'], function (assert, value) {
7 | assert.true(Boolean(value));
8 | });
9 | });
10 |
--------------------------------------------------------------------------------
/demos/grunt-contrib-qunit/fail-assert.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | test markup
13 |
14 |
15 |
--------------------------------------------------------------------------------
/test/cli/fixtures/seed.tap.txt:
--------------------------------------------------------------------------------
1 | # name: --seed value
2 | # command: ["qunit", "--seed", "s33d", "test", "basic-one.js", "glob/**/*-test.js"]
3 |
4 | Running tests with seed: s33d
5 | TAP version 13
6 | ok 1 Second > 1
7 | ok 2 Extension MJS > example
8 | ok 3 Nested-Test > herp
9 | ok 4 Extension CJS > example
10 | ok 5 A-Test > derp
11 | ok 6 First > 1
12 | ok 7 Single > has a test
13 | 1..7
14 | # pass 7
15 | # skip 0
16 | # todo 0
17 | # fail 0
18 |
--------------------------------------------------------------------------------
/docs/_posts/2020-07-31-speedlify-category.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "Link: Speedlify for Testing Tools"
4 | author: krinkle
5 | tags:
6 | - link
7 | ---
8 |
9 | Speedlify wrote on [Twitter](https://twitter.com/speedlify/status/1289252992231776259):
10 |
11 | > At the request of @TimoTijhof we created a category for Front-end Testing Tools:
12 | >
13 | > test markup
17 |
18 |
19 |
--------------------------------------------------------------------------------
/test/main/callbacks.js:
--------------------------------------------------------------------------------
1 | QUnit.module('callbacks', function () {
2 | QUnit.test('QUnit.testDone [failure]', function (assert) {
3 | assert.throws(function () {
4 | QUnit.testDone(undefined);
5 | }, TypeError, 'undefined callback');
6 |
7 | assert.throws(function () {
8 | QUnit.testDone(null);
9 | }, TypeError, 'null callback');
10 |
11 | assert.throws(function () {
12 | QUnit.testDone('banana');
13 | }, TypeError, 'string callback');
14 | });
15 | });
16 |
--------------------------------------------------------------------------------
/docs/_posts/2025-11-29-qunit-2-24-3.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.24.3 Released: Bug fix"
4 | author: krinkle
5 | excerpt: Yet another TAP compliance fix.
6 | tags:
7 | - release
8 | ---
9 |
10 | ### Fixed
11 |
12 | * CLI: Fix TAP compliance for test plan when using `QUnit.test.only()`. [4b87bc6aa5](https://github.com/qunitjs/qunit/commit/4b87bc6aa54afdcbb4e2c0c8c5ed277b68171507)
13 |
14 | ## See also
15 |
16 | * [Git tag: 2.24.3](https://github.com/qunitjs/qunit/releases/tag/2.24.3)
17 |
--------------------------------------------------------------------------------
/test/preconfig-flat-testId.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | 
15 |
--------------------------------------------------------------------------------
/test/cli/fixtures/callbacks-rejected.tap.txt:
--------------------------------------------------------------------------------
1 | # name: rejection from callbacks
2 | # command: ["qunit", "callbacks-rejected.js"]
3 |
4 | TAP version 13
5 | not ok 1 global failure
6 | ---
7 | message: "Error: begin"
8 | severity: failed
9 | stack: |
10 | Error: begin
11 | at /qunit/test/cli/fixtures/callbacks-rejected.js:8:25
12 | at qunit.js
13 | at internal
14 | ...
15 | Bail out! Error: begin
16 |
17 | # stderr
18 | Error: Process exited before tests finished running
19 |
20 | # exit code: 1
21 |
--------------------------------------------------------------------------------
/test/cli/fixtures/assert-throws-failure.tap.txt:
--------------------------------------------------------------------------------
1 | # name: report assert.throws() failures properly
2 | # command: ["qunit", "assert-throws-failure.js"]
3 |
4 | TAP version 13
5 | not ok 1 Throws match > bad
6 | ---
7 | message: match error
8 | severity: failed
9 | actual : "Error: Match me with a pattern"
10 | expected: "/incorrect pattern/"
11 | stack: |
12 | at /qunit/test/cli/fixtures/assert-throws-failure.js:3:12
13 | ...
14 | 1..1
15 | # pass 0
16 | # skip 0
17 | # todo 0
18 | # fail 1
19 |
20 | # exit code: 1
21 |
--------------------------------------------------------------------------------
/test/cli/fixtures/only-test.js:
--------------------------------------------------------------------------------
1 | QUnit.test('implicitly skipped test', function (assert) {
2 | assert.true(false, 'test should be skipped');
3 | });
4 |
5 | QUnit.only('run this test', function (assert) {
6 | assert.true(true, 'only this test should run');
7 | });
8 |
9 | QUnit.test('another implicitly skipped test', function (assert) {
10 | assert.true(false, 'test should be skipped');
11 | });
12 |
13 | QUnit.only('all tests with only run', function (assert) {
14 | assert.true(true, 'this test should run as well');
15 | });
16 |
--------------------------------------------------------------------------------
/test/cli/fixtures/async-test-throw.js:
--------------------------------------------------------------------------------
1 | QUnit.test('throw early', async function (_assert) {
2 | throw new Error('boo');
3 | });
4 |
5 | QUnit.test('throw late', async function (assert) {
6 | await Promise.resolve('');
7 | assert.true(true);
8 | throw new Error('boo');
9 | });
10 |
11 | // See "bad thenable" in /src/test.js#resolvePromise
12 | QUnit.test('test with bad thenable', function (assert) {
13 | assert.true(true);
14 | return {
15 | then: function () {
16 | throw new Error('boo');
17 | }
18 | };
19 | });
20 |
--------------------------------------------------------------------------------
/test/cli/fixtures/config-requireExpects.tap.txt:
--------------------------------------------------------------------------------
1 | # name: assert.expect() missing and config.requireExpects=true
2 | # command: ["qunit","config-requireExpects.js"]
3 |
4 | TAP version 13
5 | not ok 1 passing test
6 | ---
7 | message: Expected number of assertions to be defined, but expect() was not called.
8 | severity: failed
9 | stack: |
10 | at /qunit/test/cli/fixtures/config-requireExpects.js:3:7
11 | at internal
12 | ...
13 | 1..1
14 | # pass 0
15 | # skip 0
16 | # todo 0
17 | # fail 1
18 |
19 | # exit code: 1
20 |
--------------------------------------------------------------------------------
/test/benchmark/micro.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | 
Use the following markup to embed a "Tested with QUnit" badge in your documentation.
7 | 8 | [](/) 9 | 10 | Copy the Markdown snippet, and e.g. paste above the title your README. 11 | 12 | ```md 13 | [](https://qunitjs.com/) 14 | ``` 15 | 16 | HTML version: 17 | 18 | ```html 19 |
20 | ```
21 |
--------------------------------------------------------------------------------
/test/cli/fixtures/unhandled-rejection.js:
--------------------------------------------------------------------------------
1 | 'use strict';
2 |
3 | QUnit.module('Unhandled Rejections', function () {
4 | QUnit.test('test passes just fine, but has a rejected promise', function (assert) {
5 | assert.true(true);
6 |
7 | const done = assert.async();
8 |
9 | Promise.resolve().then(function () {
10 | throw new Error('Error thrown in non-returned promise!');
11 | });
12 |
13 | // prevent test from exiting before unhandled rejection fires
14 | setTimeout(done, 10);
15 | });
16 |
17 | Promise.reject(new Error('outside of a test context'));
18 | });
19 |
--------------------------------------------------------------------------------
/docs/_posts/2020-09-09-qunit-2-11-2.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.11.2 Released: Improve TAP output"
4 | author: krinkle
5 | tags:
6 | - release
7 | ---
8 |
9 | Improved TAP output alignment. Thanks @rwjblue!
10 |
11 | ## Changelog
12 |
13 | ### Fixed
14 |
15 | * CLI: Align `actual` whitespace with `expected` in TapReporter. (Robert Jackson) [js-reporters/js-reporters#107](https://github.com/js-reporters/js-reporters/pull/107) [#1481](https://github.com/qunitjs/qunit/pull/1481)
16 |
17 | ## See also
18 |
19 | * [Git tag: 2.11.2](https://github.com/qunitjs/qunit/releases/tag/2.11.2)
20 |
--------------------------------------------------------------------------------
/test/cli/fixtures/preconfig-flat.tap.txt:
--------------------------------------------------------------------------------
1 | # command: ["qunit", "preconfig-flat.js"]
2 | # env: { "qunit_config_filter": "!foobar", "qunit_config_seed": "dummyfirstyes", "qunit_config_testtimeout": 7, "qunit_config_altertitle": "true", "qunit_config_noglobals": 1, "qunit_config_notrycatch": "false" }
3 |
4 | Running tests with seed: dummyfirstyes
5 | TAP version 13
6 | ok 1 dummy
7 | not ok 2 slow
8 | ---
9 | message: Test took longer than 7ms; test timed out.
10 | severity: failed
11 | ...
12 | ok 3 config
13 | 1..3
14 | # pass 2
15 | # skip 0
16 | # todo 0
17 | # fail 1
18 |
19 | # exit code: 1
--------------------------------------------------------------------------------
/docs/_posts/2017-04-10-qunit-2-3-1.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.3.1 Released: Bug fixes"
4 | author: trentmwillis
5 | tags:
6 | - release
7 | ---
8 |
9 | ## Changelog
10 |
11 | * Assert: Allow assertions after async.
12 | * Assert: Throw if async callback invoked after test finishes.
13 | * Core: Ensure assertions occur while test is running.
14 | * Core: Fix test instance memory leak. [#1138](https://github.com/qunitjs/qunit/issues/1138)
15 | * Core: Slim assertions after reporting them.
16 |
17 | ## See also
18 |
19 | * [Git tag: 2.3.1](https://github.com/qunitjs/qunit/releases/tag/2.3.1)
20 |
--------------------------------------------------------------------------------
/docs/_posts/2019-02-21-qunit-2-9-2.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.9.2 Released: Bug fixes"
4 | author: trentmwillis
5 | tags:
6 | - release
7 | ---
8 |
9 | A few bug fixes.
10 |
11 | ## Changelog
12 |
13 | ### Fixed
14 |
15 | * Core: Ensure semaphores are balanced when timeout occurs. (Steve Calvert) [#1376](https://github.com/qunitjs/qunit/pull/1376)
16 | * HTML Reporter: Avoid inline styles to support CSP without `unsafe-inline`. (jelhan) [#1369](https://github.com/qunitjs/qunit/pull/1369)
17 |
18 | ## See also
19 |
20 | * [Git tag: 2.9.2](https://github.com/qunitjs/qunit/releases/tag/2.9.2)
21 |
--------------------------------------------------------------------------------
/.github/workflows/reproducible.yaml:
--------------------------------------------------------------------------------
1 | name: Reproducible builds
2 | on:
3 | # Once a week on Monday at 00:30 UTC
4 | schedule:
5 | - cron: '30 0 * * 1'
6 | # Or manually
7 | workflow_dispatch:
8 |
9 | jobs:
10 | run:
11 | name: Verify releases
12 | if: ${{ github.repository == 'qunitjs/qunit' }} # skip noisy cron on forks
13 | runs-on: ubuntu-22.04
14 | steps:
15 | - uses: actions/checkout@v4
16 |
17 | - name: Use Node.js 18
18 | uses: actions/setup-node@v4
19 | with:
20 | node-version: 18.x
21 |
22 | - run: node build/reproducible-builds.js
23 |
--------------------------------------------------------------------------------
/test/cli/fixtures/only-module-then-test.js:
--------------------------------------------------------------------------------
1 | // https://github.com/qunitjs/qunit/issues/1645
2 | QUnit.module('module A', function () {
3 | QUnit.test('test A1', function (assert) {
4 | assert.true(false, 'not run');
5 | });
6 |
7 | QUnit.module.only('module B', function () {
8 | QUnit.test('test B', function (assert) {
9 | assert.true(true, 'run');
10 | });
11 | });
12 |
13 | QUnit.test.only('test A2', function (assert) {
14 | assert.true(false, 'not run');
15 | });
16 |
17 | QUnit.test('test A3', function (assert) {
18 | assert.true(false, 'not run');
19 | });
20 | });
21 |
--------------------------------------------------------------------------------
/test/seed.js:
--------------------------------------------------------------------------------
1 | QUnit.config.seed = '7x9';
2 |
3 | var lastTest = '';
4 |
5 | QUnit.module('QUnit.config.seed');
6 |
7 | QUnit.test('1', function (assert) {
8 | assert.equal(lastTest, '2', 'runs third');
9 | lastTest = '1';
10 | });
11 |
12 | QUnit.test('2', function (assert) {
13 | assert.equal(lastTest, '3', 'runs second');
14 | lastTest = '2';
15 | });
16 |
17 | QUnit.test('3', function (assert) {
18 | assert.equal(lastTest, '', 'runs first');
19 | lastTest = '3';
20 | });
21 |
22 | QUnit.test('4', function (assert) {
23 | assert.equal(lastTest, '1', 'runs last');
24 | lastTest = '4';
25 | });
26 |
--------------------------------------------------------------------------------
/docs/_posts/2023-09-15-qunitx.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "Link: QUnitX"
4 | author: krinkle
5 | tags:
6 | - link
7 | ---
8 |
9 | Check out QUnitX by [@izelnakri](https://ruby.social/@izelnakri):
10 |
11 | | type | 17 |`boolean` | 18 |
|---|---|
| default | 21 |`false` | 22 |
| type | 17 |`boolean` | 18 |
|---|---|
| default | 21 |`true` | 22 |
Hi there, stranger!
'; 6 | 7 | QUnit.test('example [first]', function (assert) { 8 | var fixture = document.querySelector('#qunit-fixture'); 9 | 10 | assert.strictEqual(fixture.textContent, 'Hi there, stranger!'); 11 | 12 | fixture.querySelector('strong').remove(); 13 | 14 | assert.strictEqual(fixture.textContent, 'Hi , stranger!'); 15 | }); 16 | 17 | QUnit.test('example [second]', function (assert) { 18 | var fixture = document.querySelector('#qunit-fixture'); 19 | assert.strictEqual(fixture.textContent, 'Hi there, stranger!'); 20 | }); 21 | -------------------------------------------------------------------------------- /docs/_posts/2018-02-27-qunit-2-5-1.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | title: "QUnit 2.5.1 Released: Bug fixes" 4 | author: trentmwillis 5 | tags: 6 | - release 7 | --- 8 | 9 | Bunch of bug fixes and doc updates; thanks to all who contributed! 😍 10 | 11 | ## Changelog 12 | 13 | ### Changed 14 | 15 | * HTML Reporter: Restore attributes on `#qunit-fixture` between tests. (Robert Jackson) [#1250](https://github.com/qunitjs/qunit/pull/1250) 16 | * Assert: Fail test if using `assert.step()` without `assert.verifySteps()`. 17 | 18 | ### Fixed 19 | 20 | * Core: Release all processing locks when Promise rejects from a test. [#1253](https://github.com/qunitjs/qunit/pull/1253) 21 | 22 | ## See also 23 | 24 | * [Git tag: 2.5.1](https://github.com/qunitjs/qunit/releases/tag/2.5.1) 25 | -------------------------------------------------------------------------------- /test/cli/fixtures/callbacks-promises.tap.txt: -------------------------------------------------------------------------------- 1 | # command: ["qunit", "callbacks-promises.js"] 2 | 3 | TAP version 13 4 | ok 1 module1 > nestedModule1 > test1 5 | ok 2 module1 > test2 6 | ok 3 module1 > nestedModule2 > test3 7 | 1..3 8 | # pass 3 9 | # skip 0 10 | # todo 0 11 | # fail 0 12 | 13 | # stderr 14 | CALLBACK: begin 15 | CALLBACK: begin2 16 | CALLBACK: moduleStart 17 | CALLBACK: moduleStart 18 | CALLBACK: testStart - test1 19 | CALLBACK: testDone - test1 20 | CALLBACK: moduleDone - module1 > nestedModule1 21 | CALLBACK: testStart - test2 22 | CALLBACK: testDone - test2 23 | CALLBACK: moduleStart 24 | CALLBACK: testStart - test3 25 | CALLBACK: testDone - test3 26 | CALLBACK: moduleDone - module1 > nestedModule2 27 | CALLBACK: moduleDone - module1 28 | CALLBACK: done 29 | -------------------------------------------------------------------------------- /test/cli/fixtures/module-nested.js: -------------------------------------------------------------------------------- 1 | // Regression test for https://github.com/qunitjs/qunit/issues/1478 2 | 3 | try { 4 | QUnit.module('module 1', () => { 5 | QUnit.test('test in module 1', assert => { 6 | assert.true(true); 7 | }); 8 | }); 9 | } catch (e) { 10 | // Ignore 11 | } 12 | 13 | try { 14 | QUnit.module('module 2', () => { 15 | // trigger an error in executeNow 16 | undefined(); 17 | 18 | QUnit.test('test in module 2', assert => { 19 | assert.true(true); 20 | }); 21 | }); 22 | } catch (e) { 23 | // Ignore 24 | } 25 | 26 | try { 27 | QUnit.module('module 3', () => { 28 | QUnit.test('test in module 3', assert => { 29 | assert.true(true); 30 | }); 31 | }); 32 | } catch (e) { 33 | // Ignore 34 | } 35 | -------------------------------------------------------------------------------- /test/sandboxed-iframe.js: -------------------------------------------------------------------------------- 1 | /* eslint-env browser */ 2 | 3 | window.parent.postMessage('hello', '*'); 4 | 5 | QUnit.on('testEnd', function (testEnd) { 6 | window.parent.postMessage( 7 | 'testEnd: ' + testEnd.name, 8 | '*' 9 | ); 10 | }); 11 | 12 | QUnit.on('runEnd', function (runEnd) { 13 | window.parent.postMessage( 14 | 'runEnd: status=' + runEnd.status + ', total=' + runEnd.testCounts.total, 15 | '*' 16 | ); 17 | }); 18 | 19 | QUnit.module('sandboxed', function () { 20 | QUnit.test('foo', function (assert) { 21 | assert.true(false); 22 | }); 23 | 24 | QUnit.test.only('bar', function (assert) { 25 | assert.true(true); 26 | }); 27 | 28 | QUnit.test.skip('quux', function (assert) { 29 | assert.true(false); 30 | }); 31 | }); 32 | -------------------------------------------------------------------------------- /demos/qunit-onerror-early.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |
17 |
18 |
19 | From Twitter ([archived](https://web.archive.org/web/20181023043044/https://twitter.com/trentmwillis/#:~:text=Prototyping%20running%20tests%20in%20parallel)).
--------------------------------------------------------------------------------
/docs/api/index.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: page-api
3 | title: QUnit API
4 | excerpt: API reference documentation for QUnit.
5 | amethyst:
6 | prepend_description_heading: false
7 | redirect_from:
8 | - "/category/all/"
9 | ---
10 |
11 | If you're new to QUnit, check out [Getting Started](../intro.md)!
12 |
13 | QUnit is a powerful, easy-to-use JavaScript unit test suite. QUnit has no dependencies and supports Node.js, SpiderMonkey, and all [major browsers](../intro.md#compatibility).
14 |
15 |
16 |
17 | * [Main methods](./QUnit/)
18 | * [Assertions](./assert/)
19 | * [Callback events](./callbacks/)
20 | * [Configuration options](./config/)
21 | * [Reporters](./reporters/)
22 | * [Extension interface](./extension/)
23 |
--------------------------------------------------------------------------------
/test/cli/fixtures/drooling-extra-done-outside.tap.txt:
--------------------------------------------------------------------------------
1 | # name: assert.async() handled outside test
2 | # command: ["qunit","drooling-extra-done-outside.js"]
3 |
4 | TAP version 13
5 | ok 1 extra done scheduled outside any test
6 | 1..1
7 | # pass 1
8 | # skip 0
9 | # todo 0
10 | # fail 0
11 | Bail out! Error: Unexpected release of async pause after tests finished.
12 | ---
13 | message: |+
14 | Error: Unexpected release of async pause after tests finished.
15 | > Test: extra done scheduled outside any test [async #1]
16 | severity: failed
17 | stack: |
18 | Error: Unexpected release of async pause after tests finished.
19 | > Test: extra done scheduled outside any test [async #1]
20 | at qunit.js
21 | at internal
22 | ...
23 |
24 | # exit code: 1
--------------------------------------------------------------------------------
/docs/_posts/2022-03-29-qunit-2-18-1.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.18.1 Released: Faster async testing"
4 | author: krinkle
5 | tags:
6 | - release
7 | ---
8 |
9 | ## Changelog
10 |
11 | ### Fixed
12 |
13 | * HTML Reporter: Fix source attribution for test definitions. (Phani Rithvij) [#1679](https://github.com/qunitjs/qunit/issues/1679)
14 | * Core: Fix preconfig support in SpiderMonkey and other environments. [0befe2aafe](https://github.com/qunitjs/qunit/commit/0befe2aafe913704db958c472ed6f2a37ec8caaf)
15 | * Core: Improve performance of async pauses with native Map when available. [aa7314b431](https://github.com/qunitjs/qunit/commit/aa7314b431db10d321109c78041747b681e1521c)
16 |
17 | ## See also
18 |
19 | * [Git tag: 2.18.1](https://github.com/qunitjs/qunit/releases/tag/2.18.1)
20 |
--------------------------------------------------------------------------------
/test/cli/fixtures/event-runEnd-memory.js:
--------------------------------------------------------------------------------
1 | QUnit.on('runEnd', function (run) {
2 | console.log(`# early runEnd total=${run.testCounts.total} passed=${run.testCounts.passed} failed=${run.testCounts.failed}`);
3 | setTimeout(function () {
4 | QUnit.on('runEnd', function (run) {
5 | console.log(`# late runEnd total=${run.testCounts.total} passed=${run.testCounts.passed} failed=${run.testCounts.failed}`);
6 | });
7 | });
8 | });
9 |
10 | QUnit.module('First', function () {
11 | QUnit.test('A', function (assert) {
12 | assert.true(true);
13 | });
14 | QUnit.test('B', function (assert) {
15 | assert.true(false);
16 | });
17 | });
18 |
19 | QUnit.module('Second', function () {
20 | QUnit.test('C', function (assert) {
21 | assert.true(true);
22 | });
23 | });
24 |
--------------------------------------------------------------------------------
/docs/resources/calc.js:
--------------------------------------------------------------------------------
1 | /**
2 | * calc.js - An example project to demonstrate QUnit.
3 | *
4 | * @author Timo Tijhof, 2022
5 | * @license 0BSD
6 | * @license Public domain
7 | */
8 |
9 | /**
10 | * @param {number} a
11 | * @param {number} b
12 | * @return {number}
13 | */
14 | export function add (a, b) {
15 | return a + b;
16 | }
17 |
18 | /**
19 | * @param {number} a
20 | * @param {number} b
21 | * @return {number}
22 | */
23 | export function substract (a, b) {
24 | return a - b;
25 | }
26 |
27 | /**
28 | * @param {number} a
29 | * @param {number} b
30 | * @return {number}
31 | */
32 | export function multiply (a, b) {
33 | return a * b;
34 | }
35 |
36 | /**
37 | * @param {number} x
38 | * @return {number}
39 | */
40 | export function square (x) {
41 | return x * x;
42 | }
43 |
--------------------------------------------------------------------------------
/test/main/events.js:
--------------------------------------------------------------------------------
1 | QUnit.module('events', function () {
2 | QUnit.test('QUnit.on [failure]', function (assert) {
3 | assert.throws(function () {
4 | QUnit.on(null, function () {
5 | assert.step('null called');
6 | });
7 | }, /must be a string/, 'null event name');
8 |
9 | assert.throws(function () {
10 | QUnit.on('banana', function () {
11 | assert.step('banana called');
12 | });
13 | }, /not a valid event/, 'unknown event name');
14 |
15 | assert.throws(function () {
16 | QUnit.on('runStart');
17 | }, /must be a function/, 'missing callback');
18 |
19 | assert.throws(function () {
20 | QUnit.on('runStart', null);
21 | }, /must be a function/, 'null callback');
22 |
23 | assert.verifySteps([]);
24 | });
25 | });
26 |
--------------------------------------------------------------------------------
/docs/resources/calc.test.js:
--------------------------------------------------------------------------------
1 | import * as calc from './calc.js';
2 |
3 | QUnit.module('calc', () => {
4 | QUnit.test('add', (assert) => {
5 | assert.equal(calc.add(1, 2), 3);
6 | assert.equal(calc.add(2, 3), 5);
7 | assert.equal(calc.add(5, -1), 4, 'negative');
8 | });
9 |
10 | QUnit.test('substract', (assert) => {
11 | assert.equal(calc.substract(3, 2), 1);
12 | assert.equal(calc.substract(5, 3), 2);
13 | assert.equal(calc.substract(5, -1), 6, 'negative');
14 | });
15 |
16 | QUnit.test('multiply', (assert) => {
17 | assert.equal(calc.multiply(7, 2), 14);
18 | });
19 |
20 | QUnit.test('square', (assert) => {
21 | assert.equal(calc.square(5), 25);
22 | assert.equal(calc.square(7), 49);
23 | assert.equal(calc.square(-8), 64, 'negative');
24 | });
25 | });
26 |
--------------------------------------------------------------------------------
/docs/_posts/2019-01-06-qunit-2-9-0.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.9.0 Released: Reduce npm dependencies"
4 | author: krinkle
5 | tags:
6 | - release
7 | ---
8 |
9 | We significantly reduced QUnit's install size by cutting down on dependencies.
10 |
11 | ## Changelog
12 |
13 | ### Fixed
14 |
15 | * Assert: Report errors from `assert.throws()` as strings. [#1333](https://github.com/qunitjs/qunit/issues/1333)
16 | * CLI: Reduce size of the npm package and dependency tree, from 142 dependencies, to 9 dependencies. (Timo Tijhof) [#1342](https://github.com/qunitjs/qunit/issues/1342)
17 | * HTML Reporter: Fix an unescaped `details.source`. (Shlomi Fish) [#1341](https://github.com/qunitjs/qunit/pull/1341)
18 |
19 | ## See also
20 |
21 | * [Git tag: 2.9.0](https://github.com/qunitjs/qunit/releases/tag/2.9.0)
22 |
--------------------------------------------------------------------------------
/docsearch.config.json:
--------------------------------------------------------------------------------
1 | {
2 | "index_name": "qunitjs_com",
3 | "start_urls": [
4 | { "url": "https://qunitjs.com/blog/", "selectors_key": "blog", "page_rank": 1 },
5 | { "url": "https://qunitjs.com", "page_rank": 20 }
6 | ],
7 | "selectors": {
8 | "lvl0": "h1",
9 | "lvl1": "h2:not(.screen-reader-text)",
10 | "lvl2": "h3:not(.screen-reader-text)",
11 | "lvl3": "h4:not(.screen-reader-text)",
12 | "lvl4": "h5:not(.screen-reader-text)",
13 | "lvl5": "h6:not(.screen-reader-text)",
14 | "text": ".content p, .content li, .content tr, .content pre"
15 | },
16 | "custom_settings": {
17 | "token_separators": ["_", "-", "."]
18 | },
19 | "selectors_exclude": [
20 | ".posts",
21 | "aside.sidebar",
22 | ".toc-wrapper"
23 | ],
24 | "scrape_start_urls": false
25 | }
26 |
--------------------------------------------------------------------------------
/docs/_posts/2025-08-19-sapui5-qunit.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "Link: Use QUnit to test your SAPUI5 applications"
4 | author: krinkle
5 | tags:
6 | - link
7 | ---
8 |
9 | Ansgar Lichter wrote [How to use latest QUnit and Sinon to test your SAPUI5 applications](https://community.sap.com/t5/technology-blog-posts-by-sap/how-to-use-latest-qunit-and-sinon-to-test-your-sapui5-applications/ba-p/14156476) on the SAP Technology Blog:
10 |
11 | > In this post, we'll walk you through a setup that allows you to integrate the latest versions of Sinon and QUnit into your SAPUI5 project, unlocking its latest features, superior type-safety, and a much-improved developer experience. Let's get started! […]
12 |
13 | (via [@scntechblogs.marianzeis.de on Bluesky](https://bsky.app/profile/scntechblogs.marianzeis.de/post/3lwqmys6cvz27))
14 |
--------------------------------------------------------------------------------
/docs/_posts/2014-01-31-qunit-1-14-0.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 1.14.0 Released"
4 | author: jzaefferer
5 | tags:
6 | - release
7 | ---
8 |
9 | ## Changelog
10 |
11 | * Addons: Remove last remnants.
12 | * Assert: `assert.throws()` now supports comparing to Error instances.
13 | * Assert: `assert.throws()` now supports comparing to error strings.
14 | * Core: Add config property for disabling default scroll-to-top.
15 | * Core: Add support for "select one" dropdowns to `QUnit.config.urlConfig`.
16 | * Core: Cache window.clearTimeout in case it gets mocked.
17 | * Core: Run multiple tests by test number.
18 | * HTML Reporter: Removing some redundant CSS code.
19 | * Release: Set main property to qunit/qunit.js.
20 |
21 | ## See also
22 |
23 | * [Git tag: 1.14.0](https://github.com/qunitjs/qunit/releases/tag/1.14.0)
24 |
--------------------------------------------------------------------------------
/docs/_posts/2017-10-21-qunit-2-4-1.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: post
3 | title: "QUnit 2.4.1 Released: CLI Improvements"
4 | author: trentmwillis
5 | tags:
6 | - release
7 | ---
8 |
9 | Lots of minor fixes and improvements to the CLI!
10 |
11 | ## Changelog
12 |
13 | * CLI: Add slight debounce to restarting tests on file watching.
14 | * CLI: Catch file load failures and report as failing tests.
15 | * CLI: Clear require cache of watched files between runs.
16 | * CLI: List available reporters when option is specified with no value.
17 | * CLI: Properly support watching files added after first run.
18 | * Core: Provide descriptive feedback when missing `QUnit.test()` callback.
19 | * HTML Reporter: Fix regression in error reporting.
20 |
21 | ## See also
22 |
23 | * [Git tag: 2.4.1](https://github.com/qunitjs/qunit/releases/tag/2.4.1)
24 |
--------------------------------------------------------------------------------
/test/cli/fixtures/async-module-error.tap.txt:
--------------------------------------------------------------------------------
1 | # name: module() with async function
2 | # command: ["qunit","async-module-error.js"]
3 |
4 | TAP version 13
5 | not ok 1 global failure
6 | ---
7 | message: |+
8 | Error: Failed to load file async-module-error.js
9 | TypeError: QUnit.module() callback must not be async. For async module setup, use hooks. https://qunitjs.com/api/QUnit/module/#hooks
10 | severity: failed
11 | stack: |
12 | TypeError: QUnit.module() callback must not be async. For async module setup, use hooks. https://qunitjs.com/api/QUnit/module/#hooks
13 | at /qunit/test/cli/fixtures/async-module-error.js:2:7
14 | at internal
15 | ...
16 | Bail out! Error: Failed to load file async-module-error.js
17 | 1..2
18 | # pass 0
19 | # skip 0
20 | # todo 0
21 | # fail 2
22 |
23 | # exit code: 1
24 |
--------------------------------------------------------------------------------
/docs/api/config/scrolltop.md:
--------------------------------------------------------------------------------
1 | ---
2 | layout: page-api
3 | title: QUnit.config.scrolltop
4 | excerpt: Scroll to the top of the page after the test run.
5 | groups:
6 | - config
7 | redirect_from:
8 | - "/config/scrolltop/"
9 | version_added: "1.14.0"
10 | ---
11 |
12 | In browser environments, scroll to the top of the page after the tests are done.
13 |
14 | | type | 17 |`boolean` | 18 |
|---|---|
| default | 21 |`true` | 22 |
IMPORTANT: QUnit is now being published as "qunit" on NPM! Previously, we were publishing as "qunitjs".
10 | 11 | The old "qunit" package was a CLI tool that came into existence prior to a built-in CLI. That package is now published as "node-qunit". 12 | 13 | Transitioning should be simple. If you are using `qunitjs@2.4.1` you just need to drop the "js"; we have republished 2.4.1 as `qunit@2.4.1`. 14 | 15 | We hope this will help fix some confusion over package names moving forward :) 16 | 17 |Plugins can extend, enhance, and modify QUnit itself; as well as the developer experience of using QUnit.
9 | 10 |-
11 | {% assign _plugins = site.data.plugins | sort: "date" | reverse -%}
12 | {%- for plugin in _plugins -%}
13 |
-
14 |
{{ plugin.name }}
15 |{{ plugin.description }}
16 |
17 | {% endfor %}
18 |
| type | 17 |`boolean` | 18 |
|---|---|
| default | 21 |`true` | 22 |
| type | 17 |`boolean` | 18 |
|---|---|
| default | 21 |`false` | 22 |
26 | 27 | This option can also be controlled via the [HTML Reporter](../../browser.md). 28 | 29 |
30 | 31 | By default, the HTML Reporter will list both passing and failing tests. Passing tests are by default collapsed to display only their name. Enable `hidepassed` to hide passing tests completely, and show only failing tests in the list. 32 | 33 | ## See also 34 | 35 | * [QUnit.config.collapse](./collapse.md) 36 | -------------------------------------------------------------------------------- /.eslintrc.base.js: -------------------------------------------------------------------------------- 1 | /* eslint-env node */ 2 | 3 | // This JS file exists to reset 'env' and 'globals', 4 | // which ESLint doesn't have a built-in way to do otherwise. 5 | // Because of this, we have to bypass semistandard. 6 | const standard = require('eslint-config-standard'); 7 | 8 | const config = Object.assign(standard, { 9 | env: {}, 10 | globals: {}, 11 | rules: Object.assign(standard.rules, { 12 | // semistandard 13 | semi: ['error', 'always'], 14 | 'no-extra-semi': 'error', 15 | // disablements 16 | 'n/no-callback-literal': 'off', 17 | 'no-lone-blocks': 'off', 18 | 'object-shorthand': 'off', 19 | 'prefer-const': 'off', 20 | 'prefer-promise-reject-errors': 'off', 21 | // extra 22 | 'operator-linebreak': ['error', 'before', { overrides: { '=': 'after', '+=': 'after' } }], 23 | eqeqeq: ['error'], 24 | 'no-unused-vars': ['error', { args: 'all', argsIgnorePattern: '^_' }] 25 | }) 26 | }); 27 | 28 | module.exports = config; 29 | -------------------------------------------------------------------------------- /test/webWorker-worker.js: -------------------------------------------------------------------------------- 1 | // This worker script gets run via test/webWorker.html 2 | 3 | /* eslint-env worker */ 4 | 5 | importScripts( 6 | '../qunit/qunit.js', 7 | 8 | // Sync with test/index.html 9 | 'main/assert.js', 10 | 'main/assert-es6.js', 11 | 'main/assert-step.js', 12 | 'main/assert-timeout.js', 13 | 'main/async.js', 14 | 'main/browser-runner.js', 15 | 'main/callbacks.js', 16 | 'main/deepEqual.js', 17 | 'main/diff.js', 18 | 'main/dump.js', 19 | 'main/each.js', 20 | 'main/events.js', 21 | 'main/HtmlReporter.js', 22 | 'main/modules.js', 23 | 'main/modules-es2018.js', 24 | // TODO: 'main/modules-esm.mjs', 25 | 'main/legacy.js', 26 | 'main/onUncaughtException.js', 27 | 'main/promise.js', 28 | 'main/setTimeout.js', 29 | 'main/stacktrace.js', 30 | 'main/TapReporter.js', 31 | 'main/test.js', 32 | 'main/utilities.js' 33 | ); 34 | 35 | QUnit.on('runEnd', function (data) { 36 | postMessage(data); 37 | }); 38 | 39 | QUnit.start(); 40 | -------------------------------------------------------------------------------- /demos/testem.js: -------------------------------------------------------------------------------- 1 | const cp = require('child_process'); 2 | const path = require('path'); 3 | const DIR = path.join(__dirname, 'testem'); 4 | 5 | function normalize (str) { 6 | return str 7 | .trim() 8 | .replace(/(Firefox) [\d.]+/g, '$1') 9 | .replace(/(\d+ ms)/g, '0 ms'); 10 | } 11 | 12 | // Fast re-runs 13 | process.env.npm_config_prefer_offline = 'true'; 14 | process.env.npm_config_update_notifier = 'false'; 15 | process.env.npm_config_audit = 'false'; 16 | 17 | QUnit.module('testem', { 18 | before: () => { 19 | cp.execSync('npm install', { cwd: DIR, encoding: 'utf8' }); 20 | } 21 | }); 22 | 23 | QUnit.test('passing test', assert => { 24 | const ret = cp.execSync('npm run -s test', { cwd: DIR, encoding: 'utf8' }); 25 | assert.strictEqual( 26 | normalize(ret), 27 | ` 28 | ok 1 Firefox - [0 ms] - add: two numbers 29 | 30 | 1..1 31 | # tests 1 32 | # pass 1 33 | # skip 0 34 | # todo 0 35 | # fail 0 36 | 37 | # ok 38 | `.trim() 39 | ); 40 | }); 41 | -------------------------------------------------------------------------------- /test/cli/fixtures/unhandled-rejection.tap.txt: -------------------------------------------------------------------------------- 1 | # name: unhandled rejection 2 | # command: ["qunit","unhandled-rejection.js"] 3 | 4 | TAP version 13 5 | not ok 1 global failure 6 | --- 7 | message: "Error: outside of a test context" 8 | severity: failed 9 | stack: | 10 | Error: outside of a test context 11 | at /qunit/test/cli/fixtures/unhandled-rejection.js:17:18 12 | at qunit.js 13 | at /qunit/test/cli/fixtures/unhandled-rejection.js:3:7 14 | at internal 15 | ... 16 | Bail out! Error: outside of a test context 17 | not ok 2 Unhandled Rejections > test passes just fine, but has a rejected promise 18 | --- 19 | message: "global failure: Error: Error thrown in non-returned promise!" 20 | severity: failed 21 | stack: | 22 | Error: Error thrown in non-returned promise! 23 | at /qunit/test/cli/fixtures/unhandled-rejection.js:10:13 24 | ... 25 | 1..2 26 | # pass 0 27 | # skip 0 28 | # todo 0 29 | # fail 2 30 | 31 | # exit code: 1 32 | -------------------------------------------------------------------------------- /docs/_posts/2023-09-23-qunit-2-20-0.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | title: "QUnit 2.20.0 Released: Improve diagnostics" 4 | author: krinkle 5 | tags: 6 | - release 7 | --- 8 | 9 | Add type check to `assert.async()` parameter, add `QUnit.reporters.perf`, and improve performance. 10 | 11 | Welcome Zixin and Hareesh as first-time QUnit contributions! 12 | 13 | ## Changelog 14 | 15 | ### Added 16 | 17 | * Core: Add `QUnit.reporters.perf`. (Timo Tijhof) [#1714](https://github.com/qunitjs/qunit/pull/1714) 18 | 19 | ### Changed 20 | 21 | * Assert: Add type check for `assert.async()` parameter. (Zixin Yin) [#1721](https://github.com/qunitjs/qunit/issues/1721) 22 | * HTML Reporter: Remove units for 0 values in qunit.css. (Hareesh) [#1715](https://github.com/qunitjs/qunit/pull/1715) 23 | 24 | ### Fixed 25 | 26 | * Core: Faster `inArray` by using Array.prototype.includes when possible. (Izel Nakri) 27 | 28 | ## See also 29 | 30 | * [Git tag: 2.20.0](https://github.com/qunitjs/qunit/releases/tag/2.20.0) 31 | -------------------------------------------------------------------------------- /docs/_posts/2018-10-10-qunit-2-7-0.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | title: "QUnit 2.7.0 Released: HTML Reporter Performance" 4 | author: trentmwillis 5 | tags: 6 | - release 7 | --- 8 | 9 | Add Performance Timeline support, and improve HTML Reporter performance. 10 | 11 | ## Changelog 12 | 13 | ### Added 14 | 15 | * HTML Reporter: Add "User Timings" for each test to the browser's Performance Timeline. (Tobias Bieniek) [#1296](https://github.com/qunitjs/qunit/pull/1296) 16 | 17 | ### Fixed 18 | 19 | * CLI: Remove need for `fsevents` extension by upgrading the `sane` package. (Stefan Penner) [#1314](https://github.com/qunitjs/qunit/pull/1314) 20 | * HTML Reporter: Fix XHTML output issue. (Shlomi Fish) [#1317](https://github.com/qunitjs/qunit/pull/1317) 21 | * HTML Reporter: Faster "hidepassed" mode by removing elements from the DOM. (Gabriel Csapo) [#1311](https://github.com/qunitjs/qunit/pull/1311) 22 | 23 | ## See also 24 | 25 | * [Git tag: 2.7.0](https://github.com/qunitjs/qunit/releases/tag/2.7.0) 26 | -------------------------------------------------------------------------------- /docs/_posts/2015-01-12-sitepoint.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | title: "Link: QUnit Tutorials - SitePoint" 4 | author: jzaefferer 5 | tags: 6 | - link 7 | --- 8 | 9 | Aurelio De Rosa wrote [What’s New in QUnit 1.16](https://web.archive.org/web/20150206130605/http://sitepoint.com/whats-new-qunit-1-16/) for the SitePoint Blog: 10 | 11 | > In December, version 1.16 of [QUnit] was released with some important changes. […] 12 | > 13 | > Updating your tests to version 1.16 now will help you in the process of the migration to version 2.0. QUnit 1.16 introduces several new methods that will become the default in the next milestone, […] 14 | 15 | ## See also 16 | 17 | * [Getting Started with QUnit - SitePoint](https://www.sitepoint.com/getting-started-qunit/) 18 | * [How to Test Asynchronous Code with QUnit - SitePoint](https://www.sitepoint.com/test-asynchronous-code-qunit/) 19 | * [QUnit Advanced Concepts: Modules and Configuration - SitePoint](https://www.sitepoint.com/qunit-advanced-concepts-modules-configuration/) 20 | -------------------------------------------------------------------------------- /docs/_posts/2019-10-08-qunit-2-9-3.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | title: "QUnit 2.9.3 Released: Faster CLI startup" 4 | author: trentmwillis 5 | tags: 6 | - release 7 | --- 8 | 9 | Contains a bunch of small fixes and documentation updates. Thanks to our contributors! 10 | 11 | ## Changelog 12 | 13 | ### Added 14 | 15 | * HTML Reporter: Display progress and runtime while test suite is executing. (Stefan Penner) [#1398](https://github.com/qunitjs/qunit/pull/1398) 16 | 17 | ### Fixed 18 | 19 | * CLI: Ignore folders mentioned in the gitignore to improve performance. (SparshithNRai) [#1384](https://github.com/qunitjs/qunit/pull/1384) 20 | * Core: Defer getting the stack trace to improve performance. (Adam Byrne) [#1401](https://github.com/qunitjs/qunit/pull/1401) 21 | * Core: Let `assert.timeout()` replace the timeout if `config.timeout` was already set. (Stephen Yeung) [#1400](https://github.com/qunitjs/qunit/pull/1400) 22 | 23 | ## See also 24 | 25 | * [Git tag: 2.9.3](https://github.com/qunitjs/qunit/releases/tag/2.9.3) 26 | -------------------------------------------------------------------------------- /test/cli/fixtures/each-array-labels.js: -------------------------------------------------------------------------------- 1 | // Automatic labels for test.each() array data where possible 2 | // https://github.com/qunitjs/qunit/issues/1733 3 | 4 | QUnit.test.each('array of arrays', [[1, 2, 3], [1, 1, 2]], function (assert, _data) { 5 | assert.true(true); 6 | }); 7 | 8 | QUnit.test.each('array of simple strings', [ 9 | 'foo', 10 | 'x'.repeat(40), 11 | '$', 12 | 'http://example.org', 13 | ' ', 14 | '' 15 | ], function (assert, _data) { 16 | assert.true(true); 17 | }); 18 | 19 | QUnit.test.each('array of mixed', [ 20 | undefined, 21 | null, 22 | false, 23 | true, 24 | 0, 25 | 1, 26 | -10, 27 | 10 / 3, 28 | 10e42, 29 | Infinity, 30 | NaN, 31 | [], 32 | {}, 33 | '999: example', 34 | 'simple string', 35 | '\b', 36 | '\n', 37 | 'y'.repeat(100) 38 | ], function (assert, _value) { 39 | assert.true(true); 40 | }); 41 | 42 | QUnit.test.each('keyed objects', { caseFoo: [1, 2, 3], caseBar: [1, 1, 2] }, function (assert, _data) { 43 | assert.true(true); 44 | }); 45 | -------------------------------------------------------------------------------- /test/cli/fixtures/test-if.js: -------------------------------------------------------------------------------- 1 | QUnit.test.if('skip me', false, function (assert) { 2 | assert.true(false); 3 | }); 4 | 5 | QUnit.test.if('keep me', true, function (assert) { 6 | assert.true(true); 7 | }); 8 | 9 | QUnit.test('regular', function (assert) { 10 | assert.true(true); 11 | }); 12 | 13 | QUnit.test.if.each('skip dataset', false, ['a', 'b'], function (assert, _data) { 14 | assert.true(false); 15 | }); 16 | 17 | QUnit.test.if.each('keep dataset', true, ['a', 'b'], function (assert, data) { 18 | assert.true(true); 19 | assert.equal(typeof data, 'string'); 20 | }); 21 | 22 | QUnit.module.if('skip group', false, function () { 23 | QUnit.test('skipper', function (assert) { 24 | assert.true(false); 25 | }); 26 | }); 27 | 28 | QUnit.module.if('keep group', true, function (hooks) { 29 | let list = []; 30 | hooks.beforeEach(function () { 31 | list.push('x'); 32 | }); 33 | QUnit.test('keeper', function (assert) { 34 | assert.true(true); 35 | assert.deepEqual(list, ['x']); 36 | }); 37 | }); 38 | -------------------------------------------------------------------------------- /docs/api/config/testId.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: page-api 3 | title: QUnit.config.testId 4 | excerpt: Select one or more tests to run, by their internal ID (HTML Reporter). 5 | groups: 6 | - config 7 | redirect_from: 8 | - "/config/testId/" 9 | version_added: "1.16.0" 10 | --- 11 | 12 | Used by the HTML Reporter, select one or more tests to run by their internal ID. 13 | 14 || type | 17 |`array` or `undefined` | 18 |
|---|---|
| default | 21 |`undefined` | 22 |
26 | 27 | This option can be controlled via the [HTML Reporter](../../browser.md) interface. 28 | 29 |
30 | 31 | This property allows QUnit to run specific tests by their internally hashed identifier. You can specify one or multiple tests to run. This option powers the "Rerun" button in the HTML Reporter. 32 | 33 | See also: 34 | * [QUnit.config.filter](./filter.md) 35 | * [QUnit.config.moduleId](./moduleId.md) 36 | -------------------------------------------------------------------------------- /docs/_posts/2025-01-25-qunit-2-24-1.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: post 3 | title: "QUnit 2.24.1 Released: Bug fixes" 4 | author: krinkle 5 | excerpt: More TAP compliance fixes, and memory for "error" events. 6 | tags: 7 | - release 8 | --- 9 | 10 | ### Fixed 11 | 12 | * CLI: Fix TAP compliance for actual/expected indent and skip/todo colors. [b4d48fc710](https://github.com/qunitjs/qunit/commit/b4d48fc7107936b26d84b632b2c2782e368ea64c) 13 | * CLI: Fix TAP compliance for early errors (e.g. syntax error in test file). [01f7780bd8](https://github.com/qunitjs/qunit/commit/01f7780bd8df3c21667e3920e0a4187cdf986c35) 14 | * Core: Add memory to late [`error` event](https://qunitjs.com/api/callbacks/QUnit.on/#the-error-event) listeners, to improve reporting of early errors. [7c2f871ac3](https://github.com/qunitjs/qunit/commit/7c2f871ac339710845cee925207f5d6a62a8ad0e) 15 | 16 | ## See also 17 | 18 | * [Git tag: 2.24.1](https://github.com/qunitjs/qunit/releases/tag/2.24.1) 19 | * [QUnit 2.24.0 Released: Add memory to the "runEnd" event]({% post_url 2025-01-20-qunit-2-24-0 %}) 20 | -------------------------------------------------------------------------------- /docs/api/config/moduleId.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: page-api 3 | title: QUnit.config.moduleId 4 | excerpt: Select one or more modules to run, by their internal ID (HTML Reporter). 5 | groups: 6 | - config 7 | redirect_from: 8 | - "/config/moduleId/" 9 | version_added: "1.23.0" 10 | --- 11 | 12 | Used by the HTML Reporter, this selects one or more modules by their internal ID to run exclusively. 13 | 14 || type | 17 |`array` or `undefined` | 18 |
|---|---|
| default | 21 |`undefined` | 22 |
26 | 27 | This option can be controlled via the [HTML Reporter](../../browser.md) interface. 28 | 29 |
30 | 31 | Specify modules by their internally hashed identifier for a given module. You can specify one or multiple modules to run. This option powers the multi-select dropdown menu in the HTML Reporter. 32 | 33 | See also: 34 | * [QUnit.config.module](./module.md) 35 | * [QUnit.config.testId](./testId.md) 36 | --------------------------------------------------------------------------------