never

Creates a never schema.

const Schema = never(message);

Parameters

Explanation

When validated, never always returns an issue. You can use message to customize the error message.

Returns

Examples

The following examples show how never can be used.

Strict object schema

Schema to prevent any unknown object properties.

Otherwise, unknown object properties are simply ignored by default.

const StrictObjectSchema = object({ key: sting() }, never());

Strict tuple schema

Schema to prevent any unknown tuple items.

Otherwise, unknown tuple items are simply ignored by default.

const StrictTupleSchema = tuple([string(), number()], never());

The following APIs can be combined with never.

Schemas

Methods