@nestjs/config

method registerWhen

static registerWhen: (
    module: ModuleMetadata,
    condition: string | ((env: NodeJS.ProcessEnv) => boolean),
    options?: { timeout?: number; debug?: boolean }
) => Promise<Required<Pick<DynamicModule, 'imports' | 'exports' | 'module'>>>;

property envVariablesLoaded

static readonly envVariablesLoaded: Promise<void>;

• This promise resolves when "dotenv" completes loading environment variables. When "ignoreEnvFile" is set to true, then it will resolve immediately after the "ConfigModule#forRoot" method is called.

method forFeature

static forFeature: (config: ConfigFactory) => DynamicModule;

• Registers configuration object (partial registration).

  Parameter config

method forRoot

static forRoot: (options?: ConfigModuleOptions) => DynamicModule;

• Loads process environment variables depending on the "ignoreEnvFile" flag and "envFilePath" value. Also, registers custom configurations globally.

  Parameter options

constructor

constructor(internalConfig?: Record<string, any>);

property changes$

readonly changes$: any;

• Returns a stream of configuration changes. Each event contains the attribute path, the old value and the new value.

method get

get: {
    <T = any>(propertyPath: KeyOf<K>): ValidatedResult<WasValidated, T>;
    <T = K, P extends Path<T> = any, R = PathValue<T, P>>(
        propertyPath: P,
        options: ConfigGetOptions
    ): ValidatedResult<WasValidated, R>;
    <T = any>(propertyPath: KeyOf<K>, defaultValue: NoInferType<T>): T;
    <T = K, P extends Path<T> = any, R = PathValue<T, P>>(
        propertyPath: P,
        defaultValue: NoInferType<R>,
        options: ConfigGetOptions
    ): Exclude<R, undefined>;
};

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host").

  Parameter propertyPath

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host").

  Parameter propertyPath

  Parameter options

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host"). It returns a default value if the key does not exist.

  Parameter propertyPath

  Parameter defaultValue

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host"). It returns a default value if the key does not exist.

  Parameter propertyPath

  Parameter defaultValue

  Parameter options

method getOrThrow

getOrThrow: {
    <T = any>(propertyPath: KeyOf<K>): Exclude<T, undefined>;
    <T = K, P extends Path<T> = any, R = PathValue<T, P>>(
        propertyPath: P,
        options: ConfigGetOptions
    ): Exclude<R, undefined>;
    <T = any>(propertyPath: KeyOf<K>, defaultValue: NoInferType<T>): Exclude<
        T,
        undefined
    >;
    <T = K, P extends Path<T> = any, R = PathValue<T, P>>(
        propertyPath: P,
        defaultValue: NoInferType<R>,
        options: ConfigGetOptions
    ): Exclude<R, undefined>;
};

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host").

  Parameter propertyPath

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host").

  Parameter propertyPath

  Parameter options

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host"). It returns a default value if the key does not exist. If the default value is undefined an exception will be thrown.

  Parameter propertyPath

  Parameter defaultValue

• Get a configuration value (either custom configuration or process environment variable) based on property path (you can use dot notation to traverse nested object, e.g. "database.host"). It returns a default value if the key does not exist. If the default value is undefined an exception will be thrown.

  Parameter propertyPath

  Parameter defaultValue

  Parameter options

method set

set: <T = any>(propertyPath: KeyOf<K>, value: T) => void;

• Sets a configuration value based on property path.

  Parameter propertyPath

  Parameter value

method setEnvFilePaths

setEnvFilePaths: (paths: string[]) => void;

• Sets env file paths from config.module.ts to parse.

  Parameter paths

property newValue

newValue: NewValue;

property oldValue

oldValue: OldValue;

property path

path: string;

property KEY

KEY: string;

method asProvider

asProvider: () => {
    imports: [ReturnType<typeof ConfigModule.forFeature>];
    useFactory: (config: T) => T;
    inject: [string];
};

property infer

infer: true;

• If present, "get" method will try to automatically infer a type of property based on the type argument specified at the "ConfigService" class-level (example: ConfigService).

property cache

cache?: boolean;

• If "true", values from the process.env object will be cached in the memory. This improves the overall application performance. See: https://github.com/nodejs/node/issues/3104

property envFilePath

envFilePath?: string | string[];

• Path to the environment file(s) to be loaded.

property expandVariables

expandVariables?: boolean | DotenvExpandOptions;

• A boolean value indicating the use of expanded variables, or object containing options to pass to dotenv-expand. If .env contains expanded variables, they'll only be parsed if this property is set to true.

property ignoreEnvFile

ignoreEnvFile?: boolean;

• If "true", environment files (.env) will be ignored.

property ignoreEnvVars

ignoreEnvVars?: boolean;

• If "true", predefined environment variables will not be validated.

property isGlobal

isGlobal?: boolean;

• If "true", registers ConfigModule as a global module. See: https://docs.nestjs.com/modules#global-modules

property load

load?: Array<ConfigFactory>;

• Array of custom configuration files to be loaded. See: https://docs.nestjs.com/techniques/configuration

property validate

validate?: (config: Record<string, any>) => Record<string, any>;

• Custom function to validate environment variables. It takes an object containing environment variables as input and outputs validated environment variables. If exception is thrown in the function it would prevent the application from bootstrapping. Also, environment variables can be edited through this function, changes will be reflected in the process.env object.

property validationOptions

validationOptions?: Record<string, any>;

• Schema validation options. See: https://joi.dev/api/?v=17.3.0#anyvalidatevalue-options

property validationSchema

validationSchema?: any;

• Environment variables validation schema (Joi).