har-validator

What is har-validator?

The har-validator npm package is a library designed to validate HTTP Archive (HAR) files. HAR files are JSON-formatted archives that track all the logging of a web browser's interaction with a site. This package ensures that HAR files adhere to the specification and structure expected, making it useful for developers working with web performance and debugging, API testing, and network monitoring.

What are har-validator's main functionalities?

HAR file validation

This feature allows developers to validate HAR files against the HAR format specification. The code sample demonstrates how to use the har-validator package to validate a HAR file. If the file is valid, it logs a success message; otherwise, it catches and logs the validation error.

const HARValidator = require('har-validator');

async function validateHAR(harData) {
  try {
    const valid = await HARValidator.har(harData);
    console.log('HAR is valid:', valid);
  } catch (err) {
    console.error('HAR validation error:', err.message);
  }
}

Other packages similar to har-validator

ajv

Ajv is a fast JSON schema validator. While not specifically designed for HAR files, it can be used to validate any JSON structure against a schema, making it a versatile alternative for general JSON validation tasks. Compared to har-validator, Ajv requires you to define or have access to the JSON schema, offering more flexibility at the cost of requiring more setup for HAR validation.

tv4

Tiny Validator (tv4) is another JSON schema validator that supports asynchronous validation and v4 of the JSON Schema standard. Similar to Ajv, it can be used for validating various JSON formats, including HAR files, if the appropriate schema is provided. It's a bit simpler and smaller than Ajv, making it a good choice for projects with less complex validation needs or tighter size constraints.

README

HAR Validator

Extremely fast HTTP Archive (HAR) validator using JSON Schema.

Install

# to use in cli
npm install --global har-validator

# to use as a module
npm install --save har-validator

Usage

  Usage: har-validator [options] <files ...>

  Options:

    -h, --help           output usage information
    -V, --version        output the version number
    -s, --schema [name]  validate schema name (log, request, response, etc ...)

Example

har-validator har.json

har-validator --schema request request.json

API

Note: as of v2.0.0 this module defaults to Promise based API. For backward comptability with v1.x an async/callback API is provided

Validate(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a full HAR object

var HAR = require('./har.json')
var validate = require('har-validator')

validate(HAR)
  .then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.log(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a log object

var validate = require('har-validator')

validate.log(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.cache(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a cache object

var validate = require('har-validator')

validate.cache(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.cacheEntry(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a "beforeRequest" or "afterRequest" objects

var validate = require('har-validator')

validate.cacheEntry(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.content(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a content object

var validate = require('har-validator')

validate.content(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.cookie(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a cookie object

var validate = require('har-validator')

validate.cookie(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.creator(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a creator object

var validate = require('har-validator')

validate.creator(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.entry(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) an entry object

var validate = require('har-validator')

validate.entry(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.log(data)

alias of Validate(data)

Validate.page(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a page object

var validate = require('har-validator')

validate.page(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.pageTimings(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a pageTimings object

var validate = require('har-validator')

validate.pageTimings(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.postData(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a postData object

var validate = require('har-validator')

validate.postData(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.record(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a record object

var validate = require('har-validator')

validate.record(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.request(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a request object

var validate = require('har-validator')

validate.request(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.response(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a response object

var validate = require('har-validator')

validate.cacheEntry(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

Validate.timings(data)

Returns a promise that resolves to the valid object.

• data: Object (Required) a timings object

var validate = require('har-validator')

validate.timings(data.then(function (HAR) {
    console.log('horray!')
  })
  .catch(function (error) {
    console.error(error)
  })

---

Callback API

Validate(data [, callback])

Returns true or false.

var HAR = require('./har.json');
var validate = require('har-validator/lib/async');

validate(HAR, function (e, valid) {
  if (e) console.log(e.errors)

  if (valid) console.log('horray!');
});

The async API provides exactly the same methods as the Promise API

---

Support

Donations are welcome to help support the continuous development of this project.

License

ISC License © Ahmad Nassri