noExcessiveNestedTestSuites

JavaScript (and super languages)

Summary

• Rule available since: v1.6.0
• Diagnostic Category: lint/complexity/noExcessiveNestedTestSuites
• This rule doesn’t have a fix.
• The default severity of this rule is information.
• This rule belongs to the following domains:
  • test
• Sources:
  • Same as jest/max-nested-describe
  • Same as vitest/max-nested-describe

How to configure

biome.json

{
  "linter": {
    "rules": {
      "complexity": {
        "noExcessiveNestedTestSuites": "error"
      }
    }
  }
}

Description

This rule enforces a maximum depth to nested describe() in test files.

To improve code clarity in your tests, the rule limits nested describe to 5.

Examples

Invalid

describe('foo', () => {
  describe('bar', () => {
    describe('baz', () => {
      describe('qux', () => {
        describe('quxx', () => {
          describe('too many', () => {
            it('should get something', () => {
              expect(getSomething()).toBe('Something');
            });
          });
        });
      });
    });
  });
});

code-block.js:6:11 lint/complexity/noExcessiveNestedTestSuites ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Excessive `describe()` nesting detected.
  
     4 │       describe(‘qux’, () => {
     5 │         describe(‘quxx’, () => {
   > 6 │           describe(‘too many’, () => {
       │           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
   > 7 │             it(‘should get something’, () => {
   > 8 │               expect(getSomething()).toBe(‘Something’);
   > 9 │             });
  > 10 │           });
       │           ^^
    11 │         });
    12 │       });
  
  ℹ Excessive nesting of describe() calls can hinder test readability.
  
  ℹ Consider refactoring and reduce the level of nested describe to improve code clarity.
  

Valid

describe('foo', () => {
  describe('bar', () => {
    it('should get something', () => {
      expect(getSomething()).toBe('Something');
    });
  });
  describe('qux', () => {
    it('should get something', () => {
      expect(getSomething()).toBe('Something');
    });
  });
});

Related links

• Disable a rule
• Configure the code fix
• Rule options
• Source Code
• Test Cases