Merge branch 'main' into feat/validate-mocked-module-path

Author: hainenber

.yarn/releases/yarn-4.10.3.cjs renamed to .yarn/releases/yarn-4.11.0.cjs

@@ -2,4 +2,4 @@ enableGlobalCache: true
 
 nodeLinker: node-modules
 
-yarnPath: .yarn/releases/yarn-4.10.3.cjs
+yarnPath: .yarn/releases/yarn-4.11.0.cjs

.yarnrc.yml

@@ -1,3 +1,10 @@
+# [29.1.0](https://github.com/jest-community/eslint-plugin-jest/compare/v29.0.1...v29.1.0) (2025-11-10)
+
+
+### Features
+
+* **prefer-lowercase-title:** allow ignoring `todo`s ([#1843](https://github.com/jest-community/eslint-plugin-jest/issues/1843)) ([4658638](https://github.com/jest-community/eslint-plugin-jest/commit/4658638ef45a58e35e9aed1fa959f9421361a476))
+
 ## [29.0.1](https://github.com/jest-community/eslint-plugin-jest/compare/v29.0.0...v29.0.1) (2025-06-18)
 
 

CHANGELOG.md

@@ -109,3 +109,18 @@ describe('MyClass', () => {
   });
 });
 ```
+
+### `ignoreTodos`
+
+This option is used to control whether
+[`todo`](https://jestjs.io/docs/api#testtodoname) Jest functions to be checked
+by this rule. By the default, the option is set to false.
+
+Example of **correct** code for the `{ "ignoreTodos": true }` option:
+
+```js
+/* eslint jest/prefer-lowercase-title: ["error", { "ignoreTodos": true }] */
+test.todo('Uppercase description');
+
+it.todo('Uppercase description');
+```

docs/rules/prefer-lowercase-title.md

@@ -175,6 +175,7 @@ describe('foo', () => {
 interface Options {
   ignoreSpaces?: boolean;
   ignoreTypeOfDescribeName?: boolean;
+  ignoreTypeOfTestName?: boolean;
   disallowedWords?: string[];
   mustNotMatch?: Partial<Record<'describe' | 'test' | 'it', string>> | string;
   mustMatch?: Partial<Record<'describe' | 'test' | 'it', string>> | string;
@@ -187,12 +188,12 @@ Default: `false`
 
 When enabled, the leading and trailing spaces won't be checked.
 
-#### `ignoreTypeOfDescribeName`
+#### `ignoreTypeOfDescribeName` & `ignoreTypeOfTestName`
 
 Default: `false`
 
-When enabled, the type of the first argument to `describe` blocks won't be
-checked.
+When enabled, the type of the first argument to `describe`/`test` blocks won't
+be checked.
 
 #### `disallowedWords`
 

docs/rules/valid-title.md

@@ -6,5 +6,11 @@
         "Accept-Encoding": "br, gzip, deflate"
       }
     }
+  ],
+  "replacementPatterns": [
+      {
+      "pattern": "^https://www\\.npmjs\\.com/package",
+      "replacement": "https://registry.npmjs.org"
+    }
   ]
 }

markdown_link_check_config.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-jest",
-  "version": "29.0.1",
+  "version": "29.1.0",
   "description": "ESLint rules for Jest",
   "keywords": [
     "eslint",
@@ -134,7 +134,7 @@
       "optional": true
     }
   },
-  "packageManager": "yarn@4.10.3",
+  "packageManager": "yarn@4.11.0",
   "engines": {
     "node": "^20.12.0 || ^22.0.0 || >=24.0.0"
   }

package.json

@@ -646,3 +646,95 @@ ruleTester.run('prefer-lowercase-title with ignoreTopLevelDescribe', rule, {
     },
   ],
 });
+
+ruleTester.run('prefer-lowercase-title with ignoreTodos', rule, {
+  valid: [
+    {
+      code: 'test.todo(`Foo`, function () {})',
+      options: [{ ignoreTodos: true }],
+    },
+    {
+      code: 'it.todo(`Foo`, function () {})',
+      options: [{ ignoreTodos: true }],
+    },
+    {
+      code: 'it.todo("Foo", () => {})',
+      options: [{ ignoreTodos: true }],
+    },
+    {
+      code: 'it.only.todo("Foo", () => {})',
+      options: [{ ignoreTodos: true }],
+    },
+    {
+      code: 'it.todo.only("Foo", () => {})',
+      options: [{ ignoreTodos: true }],
+    },
+  ],
+  invalid: [
+    {
+      code: "describe('Foo', function () {})",
+      output: "describe('foo', function () {})",
+      options: [{ ignoreTodos: true }],
+      errors: [
+        {
+          messageId: 'unexpectedCase',
+          data: { method: DescribeAlias.describe },
+          column: 10,
+          line: 1,
+        },
+      ],
+    },
+    {
+      code: "it('Foo', function () {})",
+      output: "it('foo', function () {})",
+      options: [{ ignoreTodos: true }],
+      errors: [
+        {
+          messageId: 'unexpectedCase',
+          data: { method: TestCaseName.it },
+          column: 4,
+          line: 1,
+        },
+      ],
+    },
+    {
+      code: "test('Foo', function () {})",
+      output: "test('foo', function () {})",
+      options: [{ ignoreTodos: true }],
+      errors: [
+        {
+          messageId: 'unexpectedCase',
+          data: { method: TestCaseName.test },
+          column: 6,
+          line: 1,
+        },
+      ],
+    },
+    {
+      code: "test.only('Foo', function () {})",
+      output: "test.only('foo', function () {})",
+      options: [{ ignoreTodos: true }],
+      errors: [
+        {
+          messageId: 'unexpectedCase',
+          data: { method: TestCaseName.test },
+          column: 11,
+          line: 1,
+        },
+      ],
+    },
+    {
+      code: "test.skip('Foo', function () {})",
+      output: "test.skip('foo', function () {})",
+      options: [{ ignoreTodos: true }],
+      errors: [
+        {
+          messageId: 'unexpectedCase',
+          data: { method: TestCaseName.test },
+          column: 11,
+          line: 1,
+        },
+      ],
+    },
+  ],
+});

src/rules/__tests__/prefer-lowercase-title.test.ts

@@ -5,6 +5,7 @@ import {
   type StringNode,
   TestCaseName,
   createRule,
+  getAccessorValue,
   getStringValue,
   isStringNode,
   isTypeOfJestFnCall,
@@ -47,6 +48,7 @@ export default createRule<
       ignore: readonly IgnorableFunctionExpressions[];
       allowedPrefixes: readonly string[];
       ignoreTopLevelDescribe: boolean;
+      ignoreTodos: boolean;
     }>,
   ],
   'unexpectedCase'
@@ -88,17 +90,33 @@ export default createRule<
             type: 'boolean',
             default: false,
           },
+          ignoreTodos: {
+            type: 'boolean',
+            default: false,
+          },
         },
         additionalProperties: false,
       },
     ],
   },
   defaultOptions: [
-    { ignore: [], allowedPrefixes: [], ignoreTopLevelDescribe: false },
+    {
+      ignore: [],
+      allowedPrefixes: [],
+      ignoreTopLevelDescribe: false,
+      ignoreTodos: false,
+    },
   ],
   create(
     context,
-    [{ ignore = [], allowedPrefixes = [], ignoreTopLevelDescribe }],
+    [
+      {
+        ignore = [],
+        allowedPrefixes = [],
+        ignoreTopLevelDescribe,
+        ignoreTodos,
+      },
+    ],
   ) {
     const ignores = populateIgnores(ignore);
     let numberOfDescribeBlocks = 0;
@@ -121,6 +139,14 @@ export default createRule<
           return;
         }
 
+        // Ignore *.todo test and/or test suites
+        if (
+          ignoreTodos &&
+          jestFnCall.members.some(s => getAccessorValue(s) === 'todo')
+        ) {
+          return;
+        }
+
         const [firstArg] = node.arguments;
 
         const description = getStringValue(firstArg);