How to fix ts-node does not support 'emitDecoratorMetadata' without 'experimentalDecorators' in TypeScript

What this error means

The error "ts-node does not support 'emitDecoratorMetadata' without 'experimentalDecorators'" appears when you're using ts-node to run TypeScript code that uses decorators with metadata emission. This is a configuration issue where your TypeScript compiler options are incomplete or inconsistent. TypeScript's decorator system has two related options: 1. **experimentalDecorators**: Enables decorator syntax support (required for using decorators) 2. **emitDecoratorMetadata**: Emits design-time type metadata for decorators (requires experimentalDecorators to be enabled first) The error occurs because ts-node validates that these options are properly configured before attempting to compile and run your code. When emitDecoratorMetadata is set to true but experimentalDecorators is false or not set, ts-node rejects the configuration as invalid. This is particularly common in frameworks like NestJS, TypeORM, or class-validator that rely on decorator metadata for dependency injection, validation, or ORM mapping. The metadata includes type information that's needed at runtime for these frameworks to work properly.

Typical symptoms

• ts-node fails with error: 'ts-node does not support 'emitDecoratorMetadata' without 'experimentalDecorators''
• Running TypeScript files with ts-node results in immediate failure
• Node.js applications using decorators fail to start when using ts-node
• Frameworks like NestJS, TypeORM, or class-validator fail to initialize
• Error occurs even before your application code executes
• The same code may work with tsc compilation but fails with ts-node execution

Common causes

1. tsconfig.json has emitDecoratorMetadata: true but experimentalDecorators is false or missing
2. Multiple tsconfig files with conflicting compiler options
3. Command-line TypeScript flags override tsconfig.json settings incorrectly
4. Using a framework template that hasn't properly configured both decorator options
5. Recent TypeScript or ts-node version update changed default behavior
6. Project configuration files (like nest-cli.json) not properly synchronized with tsconfig.json

How to fix "ts-node does not support 'emitDecoratorMetadata' without 'experimentalDecorators'"

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    // Other compiler options...
    "target": "ES2022",
    "module": "commonjs",
    "strict": true
  }
}

# For NestJS projects
cat tsconfig.json | grep -A2 -B2 "experimentalDecorators"
cat tsconfig.json | grep -A2 -B2 "emitDecoratorMetadata"

# Run with --show-config to see what ts-node is using
npx ts-node --show-config

# Or specify the tsconfig explicitly
npx ts-node -P tsconfig.json your-file.ts

# For projects with multiple configs (like tsconfig.build.json)
npx ts-node -P tsconfig.build.json your-file.ts

// tsconfig.json (development)
{
  "extends": "./tsconfig.base.json",
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

// tsconfig.build.json (production)
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

// package.json - WRONG example
{
  "scripts": {
    "start": "ts-node --compiler-options '{"emitDecoratorMetadata":true}' src/main.ts"
  }
}

// Option 1: Specify both options
{
  "scripts": {
    "start": "ts-node --compiler-options '{"experimentalDecorators":true,"emitDecoratorMetadata":true}' src/main.ts"
  }
}

// Option 2: Use tsconfig.json (recommended)
{
  "scripts": {
    "start": "ts-node -P tsconfig.json src/main.ts"
  }
}

# Check nest-cli.json configuration
cat nest-cli.json

# Ensure it references the correct tsconfig
{
  "collection": "@nestjs/schematics",
  "sourceRoot": "src",
  "compilerOptions": {
    "tsConfigPath": "tsconfig.json"
  }
}

# Check current versions
npx ts-node --version
npx tsc --version

# Update packages
npm install --save-dev typescript@latest ts-node@latest

# Or update with specific versions
npm install --save-dev typescript@5.3.0 ts-node@10.9.0

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

// register.ts or main.ts
import { register } from 'ts-node';

register({
  compilerOptions: {
    experimentalDecorators: true,
    emitDecoratorMetadata: true,
    target: 'ES2022',
    module: 'commonjs'
  }
});

// Now import your application
import { AppModule } from './app.module';
// ... rest of your code

// In your main JavaScript file
require('ts-node').register({
  compilerOptions: {
    experimentalDecorators: true,
    emitDecoratorMetadata: true
  }
});

require('./src/main.ts');

// jest.config.js
module.exports = {
  preset: 'ts-jest',
  globals: {
    'ts-jest': {
      tsconfig: {
        experimentalDecorators: true,
        emitDecoratorMetadata: true
      }
    }
  }
};

# Compile TypeScript to JavaScript
npx tsc

# Run the compiled JavaScript
node dist/main.js

{
  "scripts": {
    "build": "tsc",
    "start": "node dist/main.js",
    "dev": "concurrently "tsc --watch" "nodemon dist/main.js""
  }
}

npm install --save-dev concurrently nodemon

npm install --save-dev ts-node-dev

{
  "scripts": {
    "dev": "ts-node-dev --respawn --transpile-only src/main.ts"
  }
}

Advanced notes

import 'reflect-metadata';

class Example {
  constructor(@Inject() private service: Service) {}
}

// At runtime, you can access:
const paramTypes = Reflect.getMetadata('design:paramtypes', Example);
// Returns [Service] - the type information

{
  "compilerOptions": {
    "target": "ES2022",
    "useDefineForClassFields": true,
    "experimentalDecorators": false,
    "emitDecoratorMetadata": false  // May not be supported with new decorators
  }
}

# Show full configuration
TS_NODE_DEBUG=true npx ts-node --show-config your-file.ts

# Check environment variables affecting ts-node
env | grep TS_NODE

# Common environment variables:
# TS_NODE_COMPILER_OPTIONS - JSON string of compiler options
# TS_NODE_PROJECT - Path to tsconfig.json
# TS_NODE_FILES - Whether to include files from tsconfig

// tsconfig.build.json (production)
{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "emitDecoratorMetadata": false  // Disable for smaller bundles
  }
}

Frequently asked questions

What does "ts-node does not support 'emitDecoratorMetadata' without 'experimental" mean?

The error "ts-node does not support 'emitDecoratorMetadata' without 'experimentalDecorators'" appears when you're using ts-node to run TypeScript code that uses decorators with metadata emission. This is a configuration issue where your TypeScript compiler options are incomplete or inconsistent. TypeScript's decorator system has two related options: 1.

How do I fix "ts-node does not support 'emitDecoratorMetadata' without 'experimental"?

This error occurs when using ts-node with decorators in TypeScript. The emitDecoratorMetadata compiler option requires experimentalDecorators to be enabled first. The fix involves updating your tsconfig.json to enable both options or adjusting your TypeScript configuration to properly support decorator metadata emission.

What causes "ts-node does not support 'emitDecoratorMetadata' without 'experimental"?

tsconfig.json has emitDecoratorMetadata: true but experimentalDecorators is false or missing Multiple tsconfig files with conflicting compiler options Command-line TypeScript flags override tsconfig.json settings incorrectly

Is the "ts-node does not support 'emitDecoratorMetadata' without 'experimental" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• ts-node: ERR_REQUIRE_ESM

  How to fix 'ts-node: ERR_REQUIRE_ESM' error in TypeScript

  MEDIUM

• 'noUncheckedIndexedAccess' requires 'strictNullChecks'

  How to fix "'noUncheckedIndexedAccess' requires 'strictNullChecks'" in TypeScript

  MEDIUM

• Cannot use 'module' option with ts-node without 'esm'

  How to fix "Cannot use 'module' option with ts-node without 'esm'" in ts-node

  MEDIUM

• The files matched by 'include' and 'exclude' settings did not contain any source files

  How to fix "The files matched by 'include' and 'exclude' settings did not contain any source files" in TypeScript

  MEDIUM

• Cannot find name 'process'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node` and then add 'node' to the types field in your tsconfig.

  How to fix "Cannot find name 'process'" in TypeScript

  MEDIUM

• Module has no exported member 'X'

  How to fix 'Module has no exported member X' error in TypeScript

  MEDIUM

Official resources & further reading

• 📚TypeScript Official Documentation
• 📖
  TypeScript TSConfig - emitDecoratorMetadata(Official Docs)
• 📖
  TypeScript Handbook - Decorators(Official Docs)
• 🐙
  ts-node GitHub Issue #1930 - emitDecoratorMetadata error(GitHub)
• Stack Overflow - ts-node emitDecoratorMetadata error
• LogRocket - TypeScript Decorators Complete Guide
• DigitalOcean - Understanding TypeScript Decorators
• ts-node GitHub - Configuration Options
• 📖
  TypeScript TSConfig - experimentalDecorators(Official Docs)