typescript-eslint · JoshuaKGoldberg · Oct 3, 2025 · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025
diff --git a/packages/eslint-plugin/src/rules/no-unused-vars.ts b/packages/eslint-plugin/src/rules/no-unused-vars.ts
@@ -35,6 +35,7 @@ export type Options = [
       destructuredArrayIgnorePattern?: string;
       ignoreClassWithStaticInitBlock?: boolean;
       ignoreRestSiblings?: boolean;
+      ignoreUsingDeclarations?: boolean;
       reportUsedIgnorePattern?: boolean;
       vars?: 'all' | 'local';
       varsIgnorePattern?: string;
@@ -49,6 +50,7 @@ interface TranslatedOptions {
   destructuredArrayIgnorePattern?: RegExp;
   ignoreClassWithStaticInitBlock: boolean;
   ignoreRestSiblings: boolean;
+  ignoreUsingDeclarations: boolean;
   reportUsedIgnorePattern: boolean;
   vars: 'all' | 'local';
   varsIgnorePattern?: RegExp;
@@ -127,6 +129,11 @@ export default createRule<Options, MessageIds>({
                 description:
                   'Whether to ignore sibling properties in `...` destructurings.',
               },
+              ignoreUsingDeclarations: {
+                type: 'boolean',
+                description:
+                  'Whether to ignore using or await using declarations.',
+              },
               reportUsedIgnorePattern: {
                 type: 'boolean',
                 description:
@@ -162,6 +169,7 @@ export default createRule<Options, MessageIds>({
         caughtErrors: 'all',
         ignoreClassWithStaticInitBlock: false,
         ignoreRestSiblings: false,
+        ignoreUsingDeclarations: false,
         reportUsedIgnorePattern: false,
         vars: 'all',
       };
@@ -173,6 +181,9 @@ export default createRule<Options, MessageIds>({
         options.args = firstOption.args ?? options.args;
         options.ignoreRestSiblings =
           firstOption.ignoreRestSiblings ?? options.ignoreRestSiblings;
+        options.ignoreUsingDeclarations =
+          firstOption.ignoreUsingDeclarations ??
+          options.ignoreUsingDeclarations;
         options.caughtErrors = firstOption.caughtErrors ?? options.caughtErrors;
         options.ignoreClassWithStaticInitBlock =
           firstOption.ignoreClassWithStaticInitBlock ??
@@ -548,6 +559,14 @@ export default createRule<Options, MessageIds>({
           continue;
         }
 
+        if (
+          def.type === TSESLint.Scope.DefinitionType.Variable &&
+          options.ignoreUsingDeclarations &&
+          (def.parent.kind === 'await using' || def.parent.kind === 'using')
+        ) {
+          continue;
+        }
+
         if (hasRestSpreadSibling(variable)) {
           continue;
         }

diff --git a/packages/eslint-plugin/tests/rules/no-unused-vars/no-unused-vars.test.ts b/packages/eslint-plugin/tests/rules/no-unused-vars/no-unused-vars.test.ts
@@ -1715,6 +1715,48 @@ export {};
       ],
       filename: 'foo.d.ts',
     },
+    {
+      code: `
+using resource = getResource();
+      `,
+      errors: [
+        {
+          data: {
+            action: 'assigned a value',
+            additional: '',
+            varName: 'resource',
+          },
+          line: 2,
+          messageId: 'unusedVar',
+        },
+      ],
+      languageOptions: {
+        parserOptions: {
+          ecmaVersion: 2026,
+        },
+      },
+    },
+    {
+      code: `
+await using resource = getResource();
+      `,
+      errors: [
+        {
+          data: {
+            action: 'assigned a value',
+            additional: '',
+            varName: 'resource',
+          },
+          line: 2,
+          messageId: 'unusedVar',
+        },
+      ],
+      languageOptions: {
+        parserOptions: {
+          ecmaVersion: 2026,
+        },
+      },
+    },
   ],
 
   valid: [
@@ -3018,5 +3060,38 @@ declare class Bar {}
       `,
       filename: 'foo.d.ts',
     },
+    {
+      code: `
+using resource = getResource();
+resource;
+      `,
+      languageOptions: {
+        parserOptions: {
+          ecmaVersion: 2026,
+        },
+      },
+    },
+    {
+      code: `
+using resource = getResource();
+      `,
+      languageOptions: {
+        parserOptions: {
+          ecmaVersion: 2026,
+        },
+      },
+      options: [{ ignoreUsingDeclarations: true }],
+    },
+    {
+      code: `
+await using resource = getResource();
+      `,
+      languageOptions: {
+        parserOptions: {
+          ecmaVersion: 2026,
+        },
+      },
+      options: [{ ignoreUsingDeclarations: true }],
+    },
   ],
 });
diff --git a/packages/eslint-plugin/tests/schema-snapshots/no-unused-vars.shot b/packages/eslint-plugin/tests/schema-snapshots/no-unused-vars.shot