Repository navigation
Document that compiler.extends can be an array #62915
Description
🔍 Search Terms
compiler.extends extends
✅ Viability Checklist
- This wouldn't be a breaking change in existing TypeScript/JavaScript code
- This wouldn't change the runtime behavior of existing JavaScript code
- This could be implemented without emitting different JS based on the types of the expressions
- This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
- This isn't a request to add a new utility type: https://github.com/microsoft/TypeScript/wiki/No-New-Utility-Types
- This feature would agree with the rest of our Design Goals: https://github.com/Microsoft/TypeScript/wiki/TypeScript-Design-Goals
⭐ Suggestion
After merging #50403, the docs at https://www.typescriptlang.org/tsconfig/#extends haven't been updated to indicate that extends may be an array.
📃 Motivating Example
Users may only learn that extends may be an array if they find the PR above.
Activity
aaron-seq commentedon Jan 8, 2026
I'll create a PR to update the documentation in the TypeScript-Website repository to reflect that the
extendsfield can accept an array of configuration files. This feature was implemented in PR #50403 and merged in TypeScript 4.9, but the documentation at https://www.typescriptlang.org/tsconfig/#extends needs to be updated.The documentation update will clarify that
extendscan be either a string or an array of strings, with later configurations overriding earlier ones.saksham-sankhla04 commentedon Jan 13, 2026
Hi, I would Like to work on this
anbv29 commentedon Sep 14, 2026
hey, can i be assigned this issue? I would love to work on it.
unrevised6419 commentedon Sep 30, 2026
For reference, these PRs in TypeScript-Website all address this same change to
packages/tsconfig-reference/copy/en/options/extends.md:Open:
Closed:
extends(TS 5.0) TypeScript-Website#3572The docs at https://www.typescriptlang.org/tsconfig/#extends still describe
extendsas a string only.