Warns when a .only function call is chained to a Mocha JavaScript test
Last updated 18 days ago by anthonyjean .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install eslint-plugin-mocha-no-only 
SYNC missed versions from official npm registry.


This package contains an ESLint rule which throws an error (or warning) when the only() method is called on describe, context, it, specify, suite and test Mocha test keywords.

Why do I need this?

only() is a useful Mocha feature that lets the test runner run one specific part of a test suite. Often, developers may end up forgetting to remove the only() method before commiting and pushing their code. This results in the CI tool running only one specific test in the suite which may end up in a false-positive build.

By having ESLint throw an error in such cases, you can rest assured your CI tool runs all your test suites.


You'll first need to install ESLint:

$ npm i eslint --save-dev

Next, install eslint-plugin-mocha-no-only:

$ npm install eslint-plugin-mocha-no-only --save-dev

Note: If you installed ESLint globally (using the -g flag) then you must also install eslint-plugin-mocha-no-only globally.


Add eslint-plugin-mocha-no-only to the plugins section of your .eslintrc configuration file. You can omit the eslint-plugin- prefix:

    "plugins": [

Then configure the rules you want to use under the rules section.

    "rules": {
        "mocha-no-only/mocha-no-only": ["error"]

Note: You may want to have a different .eslintrc file in your tests directory and place this plugin and rule in it. This would make sure ESLint doesn't throw errors on other JavaScript object named describe.only(), for example. There's also no need to have ESLint watch for this rule in files where there are no mocha tests.



  describe("foobar", function() {
    var foo;
    beforeEach(function() {
      foo = new Foo();

    it.only("should do things", function() {


  describe("foobar", function() {
    var foo;
    beforeEach(function() {
      foo = new Foo();

    it("should do things", function() {

Current Tags

  • 1.1.1                                ...           latest (18 days ago)

9 Versions

  • 1.1.1                                ...           18 days ago
  • 1.1.0                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
  • 0.0.6                                ...           2 years ago
  • 0.0.5                                ...           3 years ago
  • 0.0.4                                ...           4 years ago
  • 0.0.3                                ...           4 years ago
  • 0.0.2                                ...           4 years ago
  • 0.0.1                                ...           4 years ago
Maintainers (1)
Today 1
This Week 8
This Month 9
Last Day 7
Last Week 15
Last Month 191
Dependencies (1)
Dev Dependencies (1)

Copyright 2014 - 2017 © |