An environment variable reader for TypeScript. Simple and minimal. ✨

This package requires typescript to be installed.

# with npm
npm install @lpgera/ts-env

# or with Yarn
yarn add @lpgera/ts-env

Reading different types of environment variables without ts-env:

if (!process.env.PORT) {
  throw new Error('process.env.PORT is missing')
}
if (!process.env.DATABASE) {
  throw new Error('process.env.DATABASE is missing')
}

const port: number = parseInt(process.env.PORT)
const database: string = process.env.DATABASE
const debug: boolean | undefined = process.env.DEBUG === 'true'

Doing the same with ts-env:

import tsEnv from '@lpgera/ts-env'

const port: number = tsEnv.numberOrThrow('PORT')
const database: string = tsEnv.stringOrThrow('DATABASE')
const debug: boolean | undefined = tsEnv.boolean('DEBUG')

Reads a string value from process.env[key].

Reads a string value from process.env[key]. Throws an error if it's undefined.

Reads a boolean value from process.env[key]. "0" and "false" are considered false, "1" and "true" are considered true. Everything else will be read as undefined.

Reads a boolean value from process.env[key]. "0" and "false" are considered false, "1" and "true" are considered true. Everything else will result in an error thrown.

Reads a number value from process.env[key]. If a number cannot be parsed, it will return undefined.

Reads a number value from process.env[key]. If a number cannot be parsed, an error will be thrown.

Reads a string array from process.env[key].

Reads a string array from process.env[key]. Throws an error if it's undefined.

Reads a number array from process.env[key]. If any item cannot be parsed, it will return undefined.

Reads a number array from process.env[key]. If any item cannot be parsed, an error will be thrown.