docs: note that globalReturn applies only with sourceType: "script" (#20630)

mdjermanovic · web-flow · commit 035fc4fbe506 · 2026-03-14T23:12:20.000+01:00
diff --git a/docs/src/use/configure/language-options.md b/docs/src/use/configure/language-options.md
@@ -45,7 +45,7 @@ If you are using the built-in ESLint parser, you can additionally change how ESL
 
 - `allowReserved` - allow the use of reserved words as identifiers (if `ecmaVersion` is `3`).
 - `ecmaFeatures` - an object indicating which additional language features you'd like to use:
-    - `globalReturn` - allow `return` statements in the global scope.
+    - `globalReturn` - allow `return` statements in the global scope. This option only applies when `languageOptions.sourceType` is set to `"script"`. When `languageOptions.sourceType` is set to `"commonjs"`, top-level `return` statements are allowed regardless of this option. When `languageOptions.sourceType` is set to `"module"`, top-level `return` statements are not allowed even if this option is set to `true`.
     - `impliedStrict` - enable global [strict mode](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Strict_mode) (if `ecmaVersion` is `5` or greater).
     - `jsx` - enable [JSX](https://facebook.github.io/jsx/).
 
