nullthrows-es

An idiomatic way to enforce values not to be null or undefined, with first-class support for TypeScript. Very lightweight with no dependencies. This package is a fork of @expo/nullthrows and outputs its build as ES Modules.

Installation and usage

``sh
npm install nullthrows-es
`

`js
import process from 'node:process';
import nullthrows from 'nullthrows-es';

// nodeEnv is guaranteed to be a string. If the environment variable is
// undefined, nullthrows throws a TypeError.
const nodeEnv = nullthrows(process.env.NODE_ENV);

// You can optionally provide a custom error message
const nodeEnv2 = nullthrows(process.env.NODE_ENV, NODE_ENV must be defined);
`

API

$3

#### Parameters
- value: the value to enforce not to be null or undefined
- message: an optional error message to use in the thrown TypeError if the given value is null or undefined

#### Type parameters
- T: the static type of value

#### Return value
Returns value if it is neither null nor undefined.

#### Throws
Throws a TypeError if value is null or undefined`.

History

This package is forked from @expo/nullthrows.