babel-plugin-comment-strova-assert v1.3.0

Strova assert

Intro

Babel plugin that transforms commented assertions to Javascript code.

Basic usage

const func = (arg1, arg2) => {
  // assert arg1
  // assert arg2 : 2nd argument is null
  return arg1 + arg2;
}

by default is transformed to log warning:

const func = (arg1, arg2) => {
  if (!function (arg) {
    return sa.assert(arg, 'notNull', [], null, false);
  }(arg1)) console.warn('Assertion error: arg1');
  if (!function (arg) {
    return sa.assert(arg, 'notNull', [], null, false);
  }(arg2)) console.warn('2nd argument is null: arg2');

  return arg1 + arg2;
};

but it can be also transformed to throw the Error:

const func = (arg1, arg2) => {
  if (!function (arg) {
    return sa.assert(arg, 'notNull', [], null, false);
  }(arg1)) throw new Error('Assertion error: arg1');
  if (!function (arg) {
    return sa.assert(arg, 'notNull', [], null, false);
  }(arg2)) throw new Error('2nd argument is null: arg2');
  
  return arg1 + arg2;
}

Examples

Exampe01

Running example01.js by npm run example01 displays transformed example/foomodule.js in the console output.

Exampe02

Running example02.js by npm run example02 runs real world code using example/foomodule.js in default plugin configuration: assertion errors are logged in the console.

npm run example02:throw runs again example02.js but with throw profile, assertion errors are thrown and caught instead just only logging them.