Neptunium, Promethium, Manganese

    @cfworker/json-schema
    TypeScript icon, indicating that this package has built-in type declarations

    1.12.5 • Public • Published

    @cfworker/json-schema

    A JSON schema validator that will run on Cloudflare workers. Supports drafts 4, 7, 2019-09, and 2020-12.

    This library is validated against the json-schema-test-suite, a series of approximately 4,500 assertions maintained along with the json-schema specification. A small set of test cases are intentionally not supported due to performance constraints or lack of feature use. These list of unsupported features are maintained in test/unsupported.ts. While this library is not the fastest due to lack of code generation, it's consistently among the most spec compliant.

    Background

    Why another JSON schema validator?

    Cloudflare workers do not have APIs required by Ajv schema compilation (eval or new Function(code)). If possible use Ajv in a build step to precompile your schema. Otherwise this library could work for you.

    Basic usage

    import { Validator } from '@cfworker/json-schema';
    
    const validator = new Validator({ type: 'number' });
    
    const result = validator.validate(7);

    Specify meta schema draft

    const validator = new Validator({ type: 'number' }, '4'); // draft-4

    Add schemas

    const validator = new Validator({
      $id: 'https://foo.bar/baz',
      $ref: '/beep'
    });
    
    validator.addSchema({ $id: 'https://foo.bar/beep', type: 'boolean' });

    Include all errors

    By default the validator stops processing after the first error. Set the shortCircuit parameter to false to emit all errors.

    const shortCircuit = false;
    
    const draft = '2019-09';
    
    const schema = {
      type: 'object',
      required: ['name', 'email', 'number', 'bool'],
      properties: {
        name: { type: 'string' },
        email: { type: 'string', format: 'email' },
        number: { type: 'number' },
        bool: { type: 'boolean' }
      }
    };
    
    const validator = new Validator(schema, draft, shortCircuit);
    
    const result = validator.validate({
      name: 'hello',
      email: 5, // invalid type
      number: 'Hello' // invalid type
      bool: 'false' // invalid type
    });

    Install

    npm i @cfworker/json-schema

    DownloadsWeekly Downloads

    8,371

    Version

    1.12.5

    License

    MIT

    Unpacked Size

    113 kB

    Total Files

    30

    Last publish

    Collaborators

    • jdanyow