schema-utils

Webpack Schema Validation Utilities

Validates options objects against a JSON Schema and
displays the output beautifully.

Requirements

This module requires a minimum of Node v6.9.0 and Webpack v4.0.0.

Getting Started

To begin, you'll need to install schema-utils:

 $ npm install @webpack-contrib/schema-utils --save-dev

API

When using the API directly, the main entry point is the serve function, which
is the default export of the module.

 const validate = require('@webpack-contrib/schema-utils');
const schema = require('path/to/schema.json');
const target = { ... }; // the options object to validate
const name = '...'; // the load or plugin name validate() is being used in

validate({ name, schema, target });

serve(options)

Returns true if validation succeeded, false validation failed and options
allow the function to return a value. (see options below).

options

Type: Object

Options for initializing and controlling the server provided. The option names
listed below belong to the options object.

exit

Type: Boolean
Default: false

If true, will instruct the validator to end the process with an error code of
1.

log

Type: Boolean
Default: false

If true, will instruct the validator to log the results of the validation (in
the event of a failure) in a
webpack-style log output. This
is typically used with throw: false.

name

Type: String
Default: undefined
Required

A String specifying the name of the loader or plugin utilizing the validator.

schema

Type: String|Object
Default: undefined
Required

A String specifying the filesystem path to the schema used for validation.
Alternatively, you may specify an object containing the JSON-parsed schema.

target

Type: Object
Default: undefined
Required

An Object containing the options to validate against the specified schema.

throw

Type: Boolean
Default: true

By default the validator will throw an error and display validation results upon
failure. If this option is set to false, the validator will not throw an error.
This is typically used in situations where a return value of false for
validate() is sufficient, a stack trace is uneeded, or when
webpack-style log output is
preferred.

Examples

Below is a basic example of how this validator might be used:

 # schema.json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "test": {
      "anyOf": [
        { "type": "array" },
        { "type": "string" },
        { "instanceof": "RegExp" }
      ]
    },
    "transform": {
      "instanceof": "Function"
    },
    "sourceMap": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

Use in a Loader

 const { getOptions } = require('loader-utils');
const validate = require('@webpack-contrib/schema-utils');

import schema from 'path/to/schema.json'

function loader (src, map) {
  const options = getOptions(this) || {};

  validate({ name: 'Loader Name', schema, target: options });

  // Code...
}

Use in a Plugin

 const validate = require('@webpack-contrib/schema-utils');
const schema = require('path/to/schema.json');

class Plugin {
  constructor (options) {
    validate({ name: 'Plugin Name', schema, target: options });

    this.options = options;
  }

  apply (compiler) {
    // Code...
  }
}

License

MIT