eslint-plugin-qunit

What is eslint-plugin-qunit?

eslint-plugin-qunit is an ESLint plugin that provides linting rules for QUnit, a JavaScript unit testing framework. It helps ensure that QUnit tests follow best practices and maintain consistency.

What are eslint-plugin-qunit's main functionalities?

Enforce QUnit test naming conventions

This rule enforces naming conventions for QUnit tests to ensure they are descriptive and consistent.

module.exports = {
  rules: {
    'qunit/test-naming-conventions': 'error'
  }
};

Prevent the use of global QUnit assertions

This rule prevents the use of global QUnit assertions, encouraging the use of the `assert` object instead.

module.exports = {
  rules: {
    'qunit/no-global-assertions': 'error'
  }
};

Disallow async calls in QUnit tests

This rule disallows the use of asynchronous calls within loops in QUnit tests to avoid potential issues with test execution.

module.exports = {
  rules: {
    'qunit/no-async-in-loops': 'error'
  }
};

Other packages similar to eslint-plugin-qunit

eslint-plugin-jest

eslint-plugin-jest is an ESLint plugin for Jest, another popular JavaScript testing framework. It provides similar linting rules to ensure best practices and consistency in Jest tests. While eslint-plugin-qunit is specific to QUnit, eslint-plugin-jest focuses on Jest.

eslint-plugin-mocha

eslint-plugin-mocha is an ESLint plugin for Mocha, a feature-rich JavaScript test framework. It offers linting rules to enforce best practices in Mocha tests. Like eslint-plugin-qunit, it aims to improve test quality and maintainability, but it is tailored for Mocha.

README

eslint-plugin-qunit

ESLint plugin containing rules useful for QUnit tests.

Configurations

You can extend from a configuration in order to simplify manual configuration of plugin rules in your project.

For more details on how to extend your configuration from a plugin configuration, please see the ESLint plugin configuration documentation.

	Name	Description
✅	recommended	This configuration includes rules which I recommend to avoid QUnit runtime errors or incorrect behavior, some of which can be difficult to debug. Some of these rules also encourage best practices that help QUnit work better for you. For ESLint .eslintrc.js legacy config, extend from "plugin:qunit/recommended". For ESLint eslint.config.js flat config, load from require('eslint-plugin-qunit/configs/recommended').

Rules

💼 Configurations enabled in.
✅ Set in the recommended configuration.
🔧 Automatically fixable by the --fix CLI option.
💡 Manually fixable by editor suggestions.

Name	Description	💼	🔧	💡
assert-args	enforce that the correct number of assert arguments are used	✅
literal-compare-order	enforce comparison assertions have arguments in the right order	✅	🔧
no-arrow-tests	disallow arrow functions as QUnit test/module callbacks		🔧
no-assert-equal	disallow the use of assert.equal	✅		💡
no-assert-equal-boolean	require use of boolean assertions	✅	🔧
no-assert-logical-expression	disallow binary logical expressions in assert arguments	✅
no-assert-ok	disallow the use of assert.ok/assert.notOk
no-async-in-loops	disallow async calls in loops	✅
no-async-module-callbacks	disallow async module callbacks	✅
no-async-test	disallow the use of asyncTest or QUnit.asyncTest	✅
no-commented-tests	disallow commented tests	✅
no-compare-relation-boolean	disallow comparing relational expressions to booleans in assertions	✅	🔧
no-conditional-assertions	disallow assertions within if statements or conditional expressions	✅
no-early-return	disallow early return in tests	✅
no-global-assertions	disallow global QUnit assertions	✅
no-global-expect	disallow global expect	✅
no-global-module-test	disallow global module/test/asyncTest	✅
no-global-stop-start	disallow global stop/start	✅
no-hooks-from-ancestor-modules	disallow the use of hooks from ancestor modules	✅
no-identical-names	disallow identical test and module names	✅
no-init	disallow use of QUnit.init	✅
no-jsdump	disallow use of QUnit.jsDump	✅
no-loose-assertions	disallow the use of assert.equal/assert.ok/assert.notEqual/assert.notOk
no-negated-ok	disallow negation in assert.ok/assert.notOk	✅	🔧
no-nested-tests	disallow nested QUnit.test() calls	✅
no-ok-equality	disallow equality comparisons in assert.ok/assert.notOk	✅	🔧
no-only	disallow QUnit.only	✅
no-qunit-push	disallow QUnit.push	✅
no-qunit-start-in-tests	disallow QUnit.start() within tests or test hooks	✅
no-qunit-stop	disallow QUnit.stop	✅
no-reassign-log-callbacks	disallow overwriting of QUnit logging callbacks	✅
no-reset	disallow QUnit.reset	✅
no-setup-teardown	disallow setup/teardown module hooks	✅	🔧
no-skip	disallow QUnit.skip
no-test-expect-argument	disallow the expect argument in QUnit.test	✅
no-throws-string	disallow assert.throws() with block, string, and message args	✅
require-expect	enforce that expect is called	✅
require-object-in-propequal	enforce use of objects as expected value in assert.propEqual	✅
resolve-async	require that async calls are resolved	✅

Contributors

Thanks goes to these wonderful people (emoji key):

Kevin Partington 💻 📖 ⚠️ 🐛 💡 👀	Jordan Eldredge ⚠️ 💬	Mitch Lloyd 💻 📖 ⚠️	John Mainz ⚠️ 🐛	Tobias Bieniek 💻 📖 ⚠️	Stephen Edgar 🐛	Timo Tijhof 📖 🤔
Ed S 🐛 💻	Brad Overton 🐛 💻	Shane Martin 🐛	ventuno 💻	Anne-Gaëlle Schall 🐛	Steve Calvert 💻	Aliaksandr Yermalayeu 💻
Bryan Mishkin 🐛 💻 📖 🤔	XhmikosR 🐛	Andrey Fel 🐛	Ray Cohen 🐛 💻	Baptiste Doucerain 💻	Darius Dzien 🚧	Derek Wickern 🐛 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Semantic Versioning Policy

Like ESLint itself, this ESLint plugin follows semantic versioning. However, due to the nature of ESLint as a code quality tool, it's not always clear when a minor or major version bump occurs. To help clarify this for everyone, we've defined the following semantic versioning policy, based on the policy used by ESLint:

• Patch release (intended not to break your lint build)
  • A bug fix in a plugin rule that results in ESLint reporting fewer errors.
  • Improvements to documentation.
  • Non-user-facing changes such as refactoring code; adding, deleting, or modifying tests; and increasing test coverage.
  • Re-releasing after a failed release (i.e., after having published a release that doesn't work for anyone).
• Minor release (might break your lint build)
  • A bug fix in a rule that results in ESLint reporting more errors.
  • A new rule is created (without being added to plugin configuration).
  • A new option to an existing rule is created (without any default options changing).
  • A new plugin configuration is created.
  • An existing rule is deprecated.
• Major release (likely to break your lint build)
  • An existing plugin configuration is changed in any way, including but not limited to:
    • A new rule is added to the configuration.
    • A rule is removed from the configuration.
    • The options used in configuration for a rule are changed
  • An existing rule is removed.
  • A backward-incompatible change is made to the options of a rule.

Changelog

8.1.2 (2024-08-22)

Bug Fixes

• eslint v9 compatibility issues (#532) (02b4c8e)