@budibase/handlebars-helpers/lib/regex.js

More than 130 Handlebars helpers in ~20 categories. Helpers can be used with Assemble, Generate, Verb, Ghost, gulp-handlebars, grunt-handlebars, consolidate, or any node.js/Handlebars project.

'use strict';

var util = { options: require('./utils/options') };
var helpers = module.exports;
const kindOf = require('kind-of');

/**
 * Convert the given string to a regular expression.
 *
 * ```handlebars
 * {{toRegex 'foo'}}
  * <!-- results in: /foo/ -->
 * ```
 * @param {String} `str`
 * @return {RegExp}
 * @api public
 * @example {{toRegex 'foo'}} -> /foo/
 */

helpers.toRegex = function(str, locals, options) {
  var opts = util.options({}, locals, options);
  return new RegExp(str, opts.flags);
};

/**
 * Returns true if the given `str` matches the given regex. A regex can
 * be passed on the context, or using the [toRegex](#toregex) helper as a
 * subexpression.
 *
 * ```handlebars
 * {{test 'bar' (toRegex 'foo')}}
  * <!-- results in: false -->
 * {{test 'foobar' (toRegex 'foo')}}
  * <!-- results in: true -->
 * {{test 'foobar' (toRegex '^foo$')}}
  * <!-- results in: false -->
 * ```
 * @param {String} `str`
 * @return {RegExp}
 * @api public
 * @example {{test 'foobar' (toRegex 'foo')}} -> true
 */

helpers.test = function(str, regex) {
  if (typeof(str) !== 'string') {
    return false;
  }
  if (kindOf(regex) !== 'regexp') {
    throw new TypeError('expected a regular expression');
  }
  return regex.test(str);
};