TypeScript Parameter Properties

​

Syntax Comparison

class ExplicitClass {
    public readonly id: number;
    private name: string;

    constructor(id: number, name: string) {
        this.id = id;
        this.name = name;
    }
}

class ParameterPropertyClass {
    constructor(public readonly id: number, private name: string) {
        // The compiler automatically generates:
        // this.id = id;
        // this.name = name;
    }
}

​

Technical Mechanics

1. Required Modifiers: A parameter is only treated as a parameter property if it is prefixed with at least one of the following modifiers: public, private, protected, or readonly. If no modifier is present, it remains a standard local constructor parameter.
2. Execution Order: The implicit assignment of parameter properties occurs before any code within the constructor body is executed. If a class inherits from a base class, the assignment occurs immediately after the super() call.
3. Combination with Default Values: Parameter properties fully support default parameter values. If a default value is provided and the argument is omitted during instantiation, the class property is initialized with the default value.

class Configuration {
    constructor(
        protected environment: string = "development",
        public readonly timeoutMs: number = 3000
    ) {}
}

​

JavaScript Emission

class User {
    constructor(private username: string) {}
}

class User {
    constructor(username) {
        this.username = username;
    }
}