SchemaValidationError
April 12, 2026 ยท View on GitHub
Custom error class thrown when Standard Schema validation fails in withJsonResponse. It has an issues property with the validation issues from the schema and a response property with the original Response object.
This error represents a schema rejection, not an HTTP failure. The request succeeded, but the response data did not match the expected schema.
Properties
name('SchemaValidationError')code('ERR_SCHEMA_VALIDATION')issues(StandardSchemaV1Issue[]) - The validation issues from the schema.response(Response) - The originalResponseobject. The body has already been consumed for JSON parsing.
Example
import {withJsonResponse, SchemaValidationError} from 'fetch-extras';
import {z} from 'zod';
const userSchema = z.object({name: z.string()});
const fetchUser = withJsonResponse({schema: userSchema})(fetch);
try {
const user = await fetchUser('/api/user');
console.log(user.name);
} catch (error) {
if (error instanceof SchemaValidationError) {
console.error(error.issues);
console.log(error.response.status);
}
}