API Reference
    Preparing search index...
    • Get a number from the environment variables.

      Parameters

      • options: GetNumberFromEnvOptions

        The options for getting the number.

        • OptionaldefaultValue?: number

          The default value to return if the environment variable is not set.

          undefined
          
        • OptionalerrorMessage?: string

          Optional error message to throw if the environment variable is not set and no default value is provided.

          "Environment variable <key> is required"
          
        • key: string

          The key of the environment variable.

      Returns number

      import { getNumberFromEnv } from '@aws-lambda-powertools/commons/utils/env';

      const myEnvVar = getNumberFromEnv({
      key: 'MY_ENV_VAR',
      errorMessage: 'MY_ENV_VAR is required for this function',
      });

      By default, the value is trimmed before being converted to a number and always required.

      You can also provide a default value, which will be returned if the environment variable is not set instead of throwing an error.

      import { getNumberFromEnv } from '@aws-lambda-powertools/commons/utils/env';

      const myEnvVar = getNumberFromEnv({
      key: 'MY_ENV_VAR',
      defaultValue: 42,
      });