expiring-todo-comments: Add ignoreDates option (#2892)

sindresorhus · web-flow · commit 95a288ba1f29 · 2026-02-14T00:20:18.000+07:00
diff --git a/docs/rules/expiring-todo-comments.md b/docs/rules/expiring-todo-comments.md
@@ -234,6 +234,26 @@ Imagine you maintain a `main` branch at a version such as 10 and always keep wor
 
 ## Options
 
+### ignoreDates
+
+Type: `boolean`\
+Default: `false`
+
+Disables expired `Expiry Date` diagnostics.
+
+This option does not disable date argument validation. For example, TODO comments with multiple dates are still reported as invalid.
+
+This is useful when your CI system runs on pull request branches but cannot reliably expose pull request context to tooling, like some `push`-only GitHub Actions workflows.
+
+```js
+"unicorn/expiring-todo-comments": [
+	"error",
+	{
+		"ignoreDates": true
+	}
+]
+```
+
 ### ignoreDatesOnPullRequests
 
 Type: `boolean`\
diff --git a/rules/expiring-todo-comments.js b/rules/expiring-todo-comments.js
@@ -266,6 +266,7 @@ function semverComparisonForOperator(operator) {
 const DEFAULT_OPTIONS = {
 	terms: ['todo', 'fixme', 'xxx'],
 	ignore: [],
+	ignoreDates: false,
 	ignoreDatesOnPullRequests: true,
 	allowWarningComments: true,
 };
@@ -357,7 +358,7 @@ const create = context => {
 			uses++;
 			const [expirationDate] = dates;
 
-			const shouldIgnore = options.ignoreDatesOnPullRequests && ci.isPR;
+			const shouldIgnore = options.ignoreDates || (options.ignoreDatesOnPullRequests && ci.isPR);
 			if (!shouldIgnore && reachedDate(expirationDate, options.date)) {
 				context.report({
 					loc: sourceCode.getLoc(comment),
@@ -552,6 +553,9 @@ const schema = [
 				type: 'array',
 				uniqueItems: true,
 			},
+			ignoreDates: {
+				type: 'boolean',
+			},
 			ignoreDatesOnPullRequests: {
 				type: 'boolean',
 			},
diff --git a/test/expiring-todo-comments.js b/test/expiring-todo-comments.js
@@ -109,6 +109,10 @@ test({
 			code: '// TODO [2001-01-01]: quite old',
 			options: [{date: '2000-01-01'}],
 		},
+		{
+			code: '// TODO [2000-01-01]: too old but ignored in all environments',
+			options: [{ignoreDates: true, ignoreDatesOnPullRequests: false}],
+		},
 		{
 			code: `// eslint-disable-next-line rule-to-test/expiring-todo-comments
 				   // TODO without a date`,
@@ -203,6 +207,11 @@ test({
 			code: '// TODO [2200-12-12, 2200-12-12]: Multiple dates',
 			errors: [avoidMultipleDatesError('2200-12-12, 2200-12-12', 'Multiple dates')],
 		},
+		{
+			code: '// TODO [2200-12-12, 2200-12-12]: Multiple dates are still invalid',
+			errors: [avoidMultipleDatesError('2200-12-12, 2200-12-12', 'Multiple dates are still invalid')],
+			options: [{ignoreDates: true}],
+		},
 		{
 			code: '// TODO [>1]: if your package.json version is >1',
 			errors: [reachedPackageVersionError('>1', 'if your package.json version is >1')],
