typescript-eslint · mdm317 · Dec 9, 2024 · Dec 16, 2024 · Dec 17, 2024 · Mar 12, 2025
diff --git a/packages/eslint-plugin/docs/rules/consistent-generic-constructors.mdx b/packages/eslint-plugin/docs/rules/consistent-generic-constructors.mdx
@@ -79,6 +79,37 @@ const set: Set<string> = new Set<string>();
 </TabItem>
 </Tabs>
 
+### `ignore`
+
+{/* insert option description */}
+
+Some constructors have different type signatures between their type and value, for example like Uint8Array.
+
+<Tabs>
+<TabItem value="❌ Incorrect">
+
+```ts option='"constructor"'
+// Incorrect because Uint8Array has deffenrent type signature and not in ignorelist
+let a: Uint8Array<ArrayBufferLike> = new Uint8Array();
+
+// Incorrect because type arguments appear in type-annotation and not in ignorelist
+let a: UserConstructor<Type> = new UserConstructor();
+```
+
+</TabItem>
+<TabItem value="✅ Correct">
+
+```ts option='"constructor", { "ignore": ["Uint8Array", "UserConstructor"] }' showPlaygroundButton
+// Correct because Uint8Array has deffenrent type signature but are included in the ignorelist.
+let a: Uint8Array<ArrayBufferLike> = new Uint8Array();
+
+// Correct because type arguments appear in type-annotations but are included in the ignorelist.
+let a: UserConstructor<Type> = new UserConstructor();
+```
+
+</TabItem>
+</Tabs>
+
 ## When Not To Use It
 
 You can turn this rule off if you don't want to enforce one kind of generic constructor style over the other.

diff --git a/packages/eslint-plugin/src/rules/consistent-generic-constructors.ts b/packages/eslint-plugin/src/rules/consistent-generic-constructors.ts
@@ -4,8 +4,13 @@ import { AST_NODE_TYPES } from '@typescript-eslint/utils';
 
 import { createRule, nullThrows, NullThrowsReasons } from '../util';
 
-export type MessageIds = 'preferConstructor' | 'preferTypeAnnotation';
-export type Options = ['constructor' | 'type-annotation'];
+type MessageIds = 'preferConstructor' | 'preferTypeAnnotation';
+type Options = [
+  'constructor' | 'type-annotation',
+  {
+    ignore?: string[];
+  }?,
+];
 
 export default createRule<Options, MessageIds>({
   name: 'consistent-generic-constructors',
@@ -29,10 +34,24 @@ export default createRule<Options, MessageIds>({
         description: 'Which constructor call syntax to prefer.',
         enum: ['type-annotation', 'constructor'],
       },
+      {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ignore: {
+            type: 'array',
+            description:
+              'A list of constructor names to ignore when enforcing the rule.',
+            items: {
+              type: 'string',
+            },
+          },
+        },
+      },
     ],
   },
-  defaultOptions: ['constructor'],
-  create(context, [mode]) {
+  defaultOptions: ['constructor', {}],
+  create(context, [mode, options]) {
     return {
       'VariableDeclarator,PropertyDefinition,AccessorProperty,:matches(FunctionDeclaration,FunctionExpression) > AssignmentPattern'(
         node:
@@ -77,7 +96,8 @@ export default createRule<Options, MessageIds>({
           lhs &&
           (lhs.type !== AST_NODE_TYPES.TSTypeReference ||
             lhs.typeName.type !== AST_NODE_TYPES.Identifier ||
-            lhs.typeName.name !== rhs.callee.name)
+            lhs.typeName.name !== rhs.callee.name ||
+            options?.ignore?.includes(lhs.typeName.name))
         ) {
           return;
         }

diff --git a/...ges/eslint-plugin/tests/docs-eslint-output-snapshots/consistent-generic-constructors.shot b/...ges/eslint-plugin/tests/docs-eslint-output-snapshots/consistent-generic-constructors.shot
diff --git a/packages/eslint-plugin/tests/rules/consistent-generic-constructors.test.ts b/packages/eslint-plugin/tests/rules/consistent-generic-constructors.test.ts
@@ -45,6 +45,10 @@ class A {
     `
 const a = function (a: Foo = new Foo<string>()) {};
     `,
+    {
+      code: 'let a: Uint8Array<ArrayBufferLike> = new Uint8Array();',
+      options: ['constructor', { ignore: ['Uint8Array'] }],
+    },
     // type-annotation
     {
       code: 'const a = new Foo();',

diff --git a/packages/eslint-plugin/tests/schema-snapshots/consistent-generic-constructors.shot b/packages/eslint-plugin/tests/schema-snapshots/consistent-generic-constructors.shot