diff --git a/packages/tsconfig-reference/copy/en/options/allowUnreachableCode.md b/packages/tsconfig-reference/copy/en/options/allowUnreachableCode.md index c38186eef950..2cd7663eef2d 100644 --- a/packages/tsconfig-reference/copy/en/options/allowUnreachableCode.md +++ b/packages/tsconfig-reference/copy/en/options/allowUnreachableCode.md @@ -3,7 +3,12 @@ display: "Allow Unreachable Code" oneline: "Error when code will never be called" --- -Set to false to disable warnings about unreachable code. +When: + +- `undefined` (default) provide suggestions as warnings to editors +- `true` unreachable code is ignored +- `false` raises compiler errors about unreachable code + These warnings are only about code which is provably unreachable due to the use of JavaScript syntax, for example: ```ts diff --git a/packages/tsconfig-reference/scripts/tsconfigRules.ts b/packages/tsconfig-reference/scripts/tsconfigRules.ts index ca7b5abbefd4..49548dc016e3 100644 --- a/packages/tsconfig-reference/scripts/tsconfigRules.ts +++ b/packages/tsconfig-reference/scripts/tsconfigRules.ts @@ -92,7 +92,7 @@ export const defaultsForOptions = { allowJs: "false", allowSyntheticDefaultImports: 'module === "system" or esModuleInterop', allowUmdGlobalAccess: "false", - allowUnreachableCode: "false", + allowUnreachableCode: "undefined", allowUnusedLabels: "false", alwaysStrict: "`false`, unless `strict` is set", charset: "utf8",