Hybrid Validator

High-performance JSON schema validator for Node.js.

Designed for:

• ⚡ maximum performance
• 🧠 smart compiled validators
• 🔧 extensibility
• 📦 minimal overhead

Why another validator?

Most validators focus on flexibility but sacrifice performance.

This project focuses on raw validation speed while still supporting:

• runtime validation
• compiled validators
• custom types
• custom validators

Installation

npm install hybrid-validator

Quick Example

import { Validator } from "hybrid-validator";

const validator = new Validator();

const schema = {
  type: "object",
  properties: {
    name: { type: "string" },
    age: { type: "number" }
  }
};

const data = {
  name: "John",
  age: 30
};

const result = validator.validate({
  schema,
  data
});

console.log(result);

Two Validation Modes

Runtime validation

Use when data is validated only once.

validator.validate({ schema, data });

Advantages:

• no compilation cost
• fastest for single validation

Compiled validation

Use when validating large datasets.

const validate = validator.compile(schema);

validate(data1);
validate(data2);
validate(data3);

Advantages:

• schema compiled once
• extremely fast repeated validation

Performance

Benchmark executed using tinybench.

Libraries compared:

• Ajv
• Zod
• Yup
• Fastest Validator

Results:

Benchmark Chart

NativeEngine        █████████████████████████████████████████ 1,186,514
CompiledValidator   ████ 94,039
Yup                 █ 11,225
Zod                 █ 7,493
FastestValidator    ▌ 3,796
AJV cold            ▏ 225

When to use which mode

Cache

Compiled schemas are automatically cached using WeakMap.

const validator = new Validator();

const validate = validator.compile(schema);

// reused from cache
const validate2 = validator.compile(schema);

Clear cache:

validator.clearCache();

Options

const validator = new Validator({
  recursive: true,
  strict: true,
  customTypes: {},
  customValidators: []
});

Architecture

Validator uses two internal engines:

Roadmap

• more JSON Schema features
• async validation
• schema precompilation
• browser support

License