module: mark type stripping as stable

marco-ippolito · targos · commit 89871592343f · 2025-11-18T15:29:15.000+01:00
PR-URL: #60600 Refs: nodejs/typescript#24 Reviewed-By: Chemi Atlow <chemi@atlow.co.il> Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com> Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com> Reviewed-By: Darshan Sen <raisinten@gmail.com> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: Jacob Smith <jacob@frende.me> Reviewed-By: Paolo Insogna <paolo@cowtech.it> Reviewed-By: Geoffrey Booth <webadmin@geoffreybooth.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Ruy Adorno <ruy@vlt.sh> Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -905,7 +905,7 @@ only recognizes double `"` for quoting. In Powershell or Git bash, both `'`
 and `"` are usable.
 
 It is possible to run code containing inline types unless the
-[`--no-experimental-strip-types`][] flag is provided.
+[`--no-strip-types`][] flag is provided.
 
 ### `--experimental-addon-modules`
 
@@ -1504,7 +1504,7 @@ changes:
 
 This configures Node.js to interpret `--eval` or `STDIN` input as CommonJS or
 as an ES module. Valid values are `"commonjs"`, `"module"`, `"module-typescript"` and `"commonjs-typescript"`.
-The `"-typescript"` values are not available with the flag `--no-experimental-strip-types`.
+The `"-typescript"` values are not available with the flag `--no-strip-types`.
 The default is no value, or `"commonjs"` if `--no-experimental-detect-module` is passed.
 
 If `--input-type` is not provided,
@@ -1821,21 +1821,6 @@ changes:
 
 Disable the experimental [`node:sqlite`][] module.
 
-### `--no-experimental-strip-types`
-
-<!-- YAML
-added: v22.6.0
-changes:
-  - version: v23.6.0
-    pr-url: https://github.com/nodejs/node/pull/56350
-    description: Type stripping is enabled by default.
--->
-
-> Stability: 1.2 - Release candidate
-
-Disable experimental type-stripping for TypeScript files.
-For more information, see the [TypeScript type-stripping][] documentation.
-
 ### `--no-experimental-websocket`
 
 <!-- YAML
@@ -1885,6 +1870,24 @@ changes:
 Disables the family autoselection algorithm unless connection options explicitly
 enables it.
 
+### `--no-strip-types`
+
+<!-- YAML
+added: v22.6.0
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/60600
+    description: Type stripping is now stable.
+  - version:
+      - v23.6.0
+      - v22.18.0
+    pr-url: https://github.com/nodejs/node/pull/56350
+    description: Type stripping is enabled by default.
+-->
+
+Disable type-stripping for TypeScript files.
+For more information, see the [TypeScript type-stripping][] documentation.
+
 ### `--no-warnings`
 
 <!-- YAML
@@ -3451,6 +3454,7 @@ one is included in the list below.
 * `--no-force-async-hooks-checks`
 * `--no-global-search-paths`
 * `--no-network-family-autoselection`
+* `--no-strip-types`
 * `--no-warnings`
 * `--node-memory-debug`
 * `--openssl-config`
@@ -4009,7 +4013,7 @@ node --stack-trace-limit=12 -p -e "Error.stackTraceLimit" # prints 12
 [`--experimental-webstorage`]: #--experimental-webstorage
 [`--heap-prof-dir`]: #--heap-prof-dir
 [`--import`]: #--importmodule
-[`--no-experimental-strip-types`]: #--no-experimental-strip-types
+[`--no-strip-types`]: #--no-strip-types
 [`--openssl-config`]: #--openssl-configfile
 [`--preserve-symlinks`]: #--preserve-symlinks
 [`--print`]: #-p---print-script
diff --git a/doc/api/process.md b/doc/api/process.md
@@ -2086,6 +2086,10 @@ This value is therefore identical to that of `process.features.tls`.
 added:
  - v23.0.0
  - v22.10.0
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/60600
+    description: Type stripping is now stable.
 -->
 
 > Stability: 1.2 - Release candidate
@@ -2094,7 +2098,7 @@ added:
 
 A value that is `"strip"` by default,
 `"transform"` if Node.js is run with `--experimental-transform-types`, and `false` if
-Node.js is run with `--no-experimental-strip-types`.
+Node.js is run with `--no-strip-types`.
 
 ## `process.features.uv`
 
diff --git a/doc/api/test.md b/doc/api/test.md
@@ -514,7 +514,7 @@ By default, Node.js will run all files matching these patterns:
 * `**/test.{cjs,mjs,js}`
 * `**/test/**/*.{cjs,mjs,js}`
 
-Unless [`--no-experimental-strip-types`][] is supplied, the following
+Unless [`--no-strip-types`][] is supplied, the following
 additional patterns are also matched:
 
 * `**/*.test.{cts,mts,ts}`
@@ -3991,7 +3991,7 @@ Can be used to abort test subtasks when the test has been aborted.
 [`--experimental-test-coverage`]: cli.md#--experimental-test-coverage
 [`--experimental-test-module-mocks`]: cli.md#--experimental-test-module-mocks
 [`--import`]: cli.md#--importmodule
-[`--no-experimental-strip-types`]: cli.md#--no-experimental-strip-types
+[`--no-strip-types`]: cli.md#--no-strip-types
 [`--test-concurrency`]: cli.md#--test-concurrency
 [`--test-coverage-exclude`]: cli.md#--test-coverage-exclude
 [`--test-coverage-include`]: cli.md#--test-coverage-include
diff --git a/doc/api/typescript.md b/doc/api/typescript.md
@@ -2,6 +2,9 @@
 
 <!-- YAML
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/60600
+    description: Type stripping is now stable.
   - version: v24.3.0
     pr-url: https://github.com/nodejs/node/pull/58643
     description: Type stripping no longer emits an experimental warning.
@@ -15,7 +18,7 @@ changes:
 
 <!--introduced_in=v22.6.0-->
 
-> Stability: 1.2 - Release candidate
+> Stability: 2 - Stable
 
 ## Enabling
 
@@ -56,6 +59,10 @@ To use TypeScript with full support for all TypeScript features, including
 
 <!-- YAML
 added: v22.6.0
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/60600
+    description: Type stripping is now stable.
 -->
 
 By default Node.js will execute TypeScript files that contains only
@@ -64,7 +71,7 @@ Node.js will replace TypeScript syntax with whitespace,
 and no type checking is performed.
 To enable the transformation of non erasable TypeScript syntax, which requires JavaScript code generation,
 such as `enum` declarations, parameter properties use the flag [`--experimental-transform-types`][].
-To disable this feature, use the flag [`--no-experimental-strip-types`][].
+To disable this feature, use the flag [`--no-strip-types`][].
 
 Node.js ignores `tsconfig.json` files and therefore
 features that depend on settings within `tsconfig.json`,
@@ -215,7 +222,7 @@ with `#`.
 [ES Modules]: esm.md
 [Full TypeScript support]: #full-typescript-support
 [`--experimental-transform-types`]: cli.md#--experimental-transform-types
-[`--no-experimental-strip-types`]: cli.md#--no-experimental-strip-types
+[`--no-strip-types`]: cli.md#--no-strip-types
 [`ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`]: errors.md#err_unsupported_typescript_syntax
 [`tsconfig` "paths"]: https://www.typescriptlang.org/tsconfig/#paths
 [`tsx`]: https://tsx.is/
diff --git a/doc/contributing/advocacy-ambassador-program.md b/doc/contributing/advocacy-ambassador-program.md
@@ -226,7 +226,7 @@ You can find their contact email in the [`README.md`](../../README.md#tsc-techni
 
 ##### Goal
 
-The goal is to raise awareness of the Node.js TypeScript Type Stripping in the JavaScript ecosystem.
+The goal is to raise awareness of the Node.js TypeScript Type stripping in the JavaScript ecosystem.
 Some of the things to highlight include:
 
 * The benefits and limitations of the current implementation.
@@ -271,7 +271,7 @@ with projects learning from one another and their users.
 | [reading environment](https://nodejs.org/api/cli.html#--env-filefile)                                 | [20.6.0](https://nodejs.org/en/blog/release/v20.6.0)   | Active Development                                                 |
 | [styling output](https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options) | [20.12.0](https://nodejs.org/en/blog/release/v20.12.0) | Stable, as of [22.13.0](https://github.com/nodejs/node/pull/56329) |
 | [run scripts](https://nodejs.org/docs/latest/api/cli.html#--run)                                      | [22.0.0](https://nodejs.org/en/blog/release/v22.0.0)   | Stable, as of 22.0.0                                               |
-| [run TypeScript](https://nodejs.org/api/cli.html#--experimental-strip-types)                          | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0)   | Active Development                                                 |
+| [run TypeScript](https://nodejs.org/api/cli.html#--strip-types)                                       | [22.6.0](https://nodejs.org/en/blog/release/v22.6.0)   | Stable, as of REPLACEME                                            |
 
 ##### Related Links
 
@@ -284,7 +284,7 @@ with projects learning from one another and their users.
 * <https://nodejs.org/api/cli.html#--env-filefile>
 * <https://nodejs.org/docs/latest-v22.x/api/util.html#utilstyletextformat-text-options>
 * <https://nodejs.org/api/cli.html#--run>
-* <https://nodejs.org/api/cli.html#--experimental-strip-types>
+* <https://nodejs.org/api/cli.html#--strip-types>
 
 <!-- lint enable prohibited-strings remark-lint-->
 
diff --git a/doc/node-config-schema.json b/doc/node-config-schema.json
@@ -168,9 +168,6 @@
         "experimental-sqlite": {
           "type": "boolean"
         },
-        "experimental-strip-types": {
-          "type": "boolean"
-        },
         "experimental-transform-types": {
           "type": "boolean"
         },
@@ -355,6 +352,9 @@
         "stack-trace-limit": {
           "type": "number"
         },
+        "strip-types": {
+          "type": "boolean"
+        },
         "test-coverage-branches": {
           "type": "number"
         },
diff --git a/doc/node.1 b/doc/node.1
@@ -210,8 +210,8 @@ Disable top-level await keyword support in REPL.
 .It Fl -no-experimental-sqlite
 Disable the experimental node:sqlite module.
 .
-.It Fl -no-experimental-strip-types
-Disable experimental type-stripping for TypeScript files.
+.It Fl -no-strip-types
+Disable type-stripping for TypeScript files.
 .
 .It Fl -experimental-vm-modules
 Enable experimental ES module support in VM module.
diff --git a/lib/internal/bootstrap/node.js b/lib/internal/bootstrap/node.js
@@ -327,7 +327,7 @@ ObjectDefineProperty(process.features, 'typescript', {
     if (kTypeStrippingMode === null) {
       if (getOptionValue('--experimental-transform-types')) {
         kTypeStrippingMode = 'transform';
-      } else if (getOptionValue('--experimental-strip-types')) {
+      } else if (getOptionValue('--strip-types')) {
         kTypeStrippingMode = 'strip';
       } else {
         kTypeStrippingMode = false;
diff --git a/lib/internal/main/eval_stdin.js b/lib/internal/main/eval_stdin.js
@@ -29,7 +29,7 @@ readStdin((code) => {
   const print = getOptionValue('--print');
   const shouldLoadESM = getOptionValue('--import').length > 0;
   const inputType = getOptionValue('--input-type');
-  const tsEnabled = getOptionValue('--experimental-strip-types');
+  const tsEnabled = getOptionValue('--strip-types');
   if (inputType === 'module') {
     evalModuleEntryPoint(code, print);
   } else if (inputType === 'module-typescript' && tsEnabled) {
diff --git a/lib/internal/main/eval_string.js b/lib/internal/main/eval_string.js
@@ -32,7 +32,7 @@ const code = getOptionValue('--eval');
 const print = getOptionValue('--print');
 const shouldLoadESM = getOptionValue('--import').length > 0 || getOptionValue('--experimental-loader').length > 0;
 const inputType = getOptionValue('--input-type');
-const tsEnabled = getOptionValue('--experimental-strip-types');
+const tsEnabled = getOptionValue('--strip-types');
 if (inputType === 'module') {
   evalModuleEntryPoint(code, print);
 } else if (inputType === 'module-typescript' && tsEnabled) {
diff --git a/lib/internal/main/worker_thread.js b/lib/internal/main/worker_thread.js
@@ -166,7 +166,7 @@ port.on('message', (message) => {
           value: filename,
         });
         ArrayPrototypeSplice(process.argv, 1, 0, name);
-        const tsEnabled = getOptionValue('--experimental-strip-types');
+        const tsEnabled = getOptionValue('--strip-types');
         const inputType = getOptionValue('--input-type');
 
         if (inputType === 'module-typescript' && tsEnabled) {
diff --git a/lib/internal/modules/cjs/loader.js b/lib/internal/modules/cjs/loader.js
@@ -1857,7 +1857,7 @@ function getRequireESMError(mod, pkg, content, filename) {
  */
 Module._extensions['.js'] = function(module, filename) {
   let format, pkg;
-  const tsEnabled = getOptionValue('--experimental-strip-types');
+  const tsEnabled = getOptionValue('--strip-types');
   if (StringPrototypeEndsWith(filename, '.cjs')) {
     format = 'commonjs';
   } else if (StringPrototypeEndsWith(filename, '.mjs')) {
diff --git a/lib/internal/modules/esm/formats.js b/lib/internal/modules/esm/formats.js
@@ -24,7 +24,7 @@ if (experimentalAddonModules) {
   extensionFormatMap['.node'] = 'addon';
 }
 
-if (getOptionValue('--experimental-strip-types')) {
+if (getOptionValue('--strip-types')) {
   extensionFormatMap['.ts'] = 'module-typescript';
   extensionFormatMap['.mts'] = 'module-typescript';
   extensionFormatMap['.cts'] = 'commonjs-typescript';
diff --git a/lib/internal/modules/esm/get_format.js b/lib/internal/modules/esm/get_format.js
@@ -132,15 +132,15 @@ function getFileProtocolModuleFormat(url, context = { __proto__: null }, ignoreE
     }
     return format;
   }
-  if (ext === '.ts' && getOptionValue('--experimental-strip-types')) {
+  if (ext === '.ts' && getOptionValue('--strip-types')) {
     const { type: packageType, pjsonPath, exists: foundPackageJson } = getPackageScopeConfig(url);
     if (packageType !== 'none') {
       return `${packageType}-typescript`;
     }
     // The controlling `package.json` file has no `type` field.
     // `source` is undefined when this is called from `defaultResolve`;
     // but this gets called again from `defaultLoad`/`defaultLoadSync`.
-    // Since experimental-strip-types depends on detect-module, we always return null if source is undefined.
+    // Since strip-types depends on detect-module, we always return null if source is undefined.
     if (!source) { return null; }
     const { stringify } = require('internal/modules/helpers');
     const { stripTypeScriptModuleTypes } = require('internal/modules/typescript');
diff --git a/lib/internal/modules/run_main.js b/lib/internal/modules/run_main.js
@@ -67,7 +67,7 @@ function shouldUseESMLoader(mainPath) {
   if (mainPath && StringPrototypeEndsWith(mainPath, '.wasm')) { return true; }
   if (!mainPath || StringPrototypeEndsWith(mainPath, '.cjs')) { return false; }
 
-  if (getOptionValue('--experimental-strip-types')) {
+  if (getOptionValue('--strip-types')) {
     if (!mainPath || StringPrototypeEndsWith(mainPath, '.cts')) { return false; }
     // This will likely change in the future to start with commonjs loader by default
     if (mainPath && StringPrototypeEndsWith(mainPath, '.mts')) { return true; }
diff --git a/lib/internal/process/execution.js b/lib/internal/process/execution.js
@@ -84,7 +84,7 @@ function evalScript(name, body, breakFirstLine, print, shouldLoadESM = false) {
   const baseUrl = pathToFileURL(module.filename).href;
 
   if (shouldUseModuleEntryPoint(name, body)) {
-    return getOptionValue('--experimental-strip-types') ?
+    return getOptionValue('--strip-types') ?
       evalTypeScriptModuleEntryPoint(body, print) :
       evalModuleEntryPoint(body, print);
   }
diff --git a/lib/internal/test_runner/utils.js b/lib/internal/test_runner/utils.js
@@ -61,7 +61,7 @@ const kRegExpPattern = /^\/(.*)\/([a-z]*)$/;
 
 const kPatterns = ['test', 'test/**/*', 'test-*', '*[._-]test'];
 const kFileExtensions = ['js', 'mjs', 'cjs'];
-if (getOptionValue('--experimental-strip-types')) {
+if (getOptionValue('--strip-types')) {
   ArrayPrototypePush(kFileExtensions, 'ts', 'mts', 'cts');
 }
 const kDefaultPattern = `**/{${ArrayPrototypeJoin(kPatterns, ',')}}.{${ArrayPrototypeJoin(kFileExtensions, ',')}}`;
diff --git a/src/node_options.cc b/src/node_options.cc
@@ -1061,17 +1061,18 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
             "ES module to preload (option can be repeated)",
             &EnvironmentOptions::preload_esm_modules,
             kAllowedInEnvvar);
-  AddOption("--experimental-strip-types",
-            "Experimental type-stripping for TypeScript files.",
-            &EnvironmentOptions::experimental_strip_types,
+  AddOption("--strip-types",
+            "Type-stripping for TypeScript files.",
+            &EnvironmentOptions::strip_types,
             kAllowedInEnvvar,
             true);
+  AddAlias("--experimental-strip-types", "--strip-types");
   AddOption("--experimental-transform-types",
             "enable transformation of TypeScript-only"
             "syntax into JavaScript code",
             &EnvironmentOptions::experimental_transform_types,
             kAllowedInEnvvar);
-  Implies("--experimental-transform-types", "--experimental-strip-types");
+  Implies("--experimental-transform-types", "--strip-types");
   Implies("--experimental-transform-types", "--enable-source-maps");
   AddOption("--interactive",
             "always enter the REPL even if stdin does not appear "
diff --git a/src/node_options.h b/src/node_options.h
@@ -256,7 +256,7 @@ class EnvironmentOptions : public Options {
 
   std::vector<std::string> preload_esm_modules;
 
-  bool experimental_strip_types = true;
+  bool strip_types = true;
   bool experimental_transform_types = false;
 
   std::vector<std::string> user_argv;

Original file line number	Diff line number	Diff line change
`@@ -210,8 +210,8 @@ Disable top-level await keyword support in REPL.`
`210`	`210`	`.It Fl -no-experimental-sqlite`
`211`	`211`	`Disable the experimental node:sqlite module.`
`212`	`212`	`.`
`213`		`-.It Fl -no-experimental-strip-types`
`214`		`-Disable experimental type-stripping for TypeScript files.`
	`213`	`+.It Fl -no-strip-types`
	`214`	`+Disable type-stripping for TypeScript files.`
`215`	`215`	`.`
`216`	`216`	`.It Fl -experimental-vm-modules`
`217`	`217`	`Enable experimental ES module support in VM module.`