Schema validation

Validate and transform stored values with a synchronous Standard Schema.

import { createStorage } from 'ultrastorage';

const storage = createStorage();

Trust no one — especially since browser storage is open to tampering by users. Validate with any libraries that support Standard Schema, as long as validation is synchronous.

import { z } from 'zod';

const UserSchema = z.object({ name: z.string(), age: z.number() });

// Returns typed value if valid, null if validation fails
const user = storage.getItem('user', { schema: UserSchema });

Read semantics

Validation happens on read, not on write. Invalid data reported as schema issues returns null and remains in storage. Successful transformations return the schema output. Async schemas throw a TypeError, and exceptions thrown by a schema propagate.

A TypeScript generic alone does not validate the persisted value. Browser storage can change outside your application, so use a schema when runtime validation matters.

For inferred React values and defaults, see React schemas and types.