apps-script-utils 2.1.1 Help

requireNonNull

function requireNonNull<T>(value?: T | null | undefined, message?: string): T;

The absent values, and only those: 0, "" and false are present values and do not qualify.

isX and nonX answer a question and never interrupt control flow; requireX and requireNonX hand the value back or throw. The scheme is explained in Validation conventions.

Parameters

Parameter

Type

Description

value (optional)

T \| null \| undefined

The value to validate.

message (optional)

string

The message of the exception. A default is used when omitted.

Returns

T — the same value, with null or undefined excluded from its type.

Throws

Exception

Condition

NullPointerException

the value is null or undefined.

Examples

What passes and what does not

requireNonNull(0); // => 0 requireNonNull(""); // => "" requireNonNull(null); // throws NullPointerException requireNonNull(undefined); // throws NullPointerException

See also

Source

src/lang/base/requireNonNull.ts

23 September 2026
requireNonNilrequireNonNumber

This documentation was generated with AI (Claude) from the library's source code.