nodejs · nodejs-github-bot · Mar 6, 2025 · Mar 4, 2025 · Mar 6, 2025 · marco-ippolito
diff --git a/doc/api/typescript.md b/doc/api/typescript.md
@@ -81,6 +81,7 @@ but we recommend version 5.8 or newer with the following `tsconfig.json` setting
 ```json
 {
   "compilerOptions": {
+     "noEmit": true, // Optional - see note below
      "target": "esnext",
      "module": "nodenext",
      "rewriteRelativeImportExtensions": true,
@@ -90,6 +91,10 @@ but we recommend version 5.8 or newer with the following `tsconfig.json` setting
 }
 ```
 
+> \[!NOTE]
+> Use the `noEmit` option if you intend to only execute `*.ts` files, for example a build script.
+> You won't need this flag if you intend to distribute `*.js` files for performance reasons.
-> You won't need this flag if you intend to distribute `*.js` files for performance reasons.
+> You won't need this flag if you intend to distribute `*.js` files.
-> You won't need this flag if you intend to distribute `*.js` files for performance reasons.
+> You won't need this flag if you intend to distribute `*.js` files.
+
 ### Determining module system
 
 Node.js supports both [CommonJS][] and [ES Modules][] syntax in TypeScript