docs: clarify "local" option of no-unused-vars (#20385)

mdjermanovic · web-flow · commit 5a4324f38e7c · 2025-12-06T21:19:25.000+01:00
diff --git a/docs/src/rules/no-unused-vars.md b/docs/src/rules/no-unused-vars.md
@@ -153,8 +153,8 @@ By default this rule is enabled with `all` option for caught errors and variable
 
 The `vars` option has two settings:
 
-* `all` checks all variables for usage, including those in the global scope. However, it excludes variables targeted by other options like `args` and `caughtErrors`. This is the default setting.
-* `local` checks only that locally-declared variables are used but will allow global variables to be unused.
+* `"all"` checks all variables for usage, including those in the global scope. However, it excludes variables targeted by other options like `args` and `caughtErrors`. This is the default setting.
+* `"local"` allows variables in the global scope to be unused.
 
 #### vars: local
 
@@ -171,6 +171,26 @@ some_unused_var = 42;
 
 :::
 
+Examples of **correct** code for the `{ "vars": "local" }` option with `"languageOptions": { "sourceType": "script" }`:
+
+::: correct { "sourceType": "script" }
+
+```js
+/*eslint no-unused-vars: ["error", { "vars": "local" }]*/
+
+const foo = 42;
+
+let bar;
+
+let baz = 42;
+
+var qux;
+
+var quux = 42;
+```
+
+:::
+
 ### varsIgnorePattern
 
 The `varsIgnorePattern` option specifies exceptions not to check for usage: variables whose names match a regexp pattern. For example, variables whose names contain `ignored` or `Ignored`. However, it excludes variables targeted by other options like `argsIgnorePattern` and `caughtErrorsIgnorePattern`.
