JSPM – commonform-regexp-annotator@1.0.2

Package Exports

commonform-regexp-annotator

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (commonform-regexp-annotator) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

The module exports a single function that takes an array of RegExp and a function for generating annotations and returns an annotator function to apply to Common Forms.

Include capture groups and flags in your RegExp as needed to match and generate annotation messages.

var expressions = [
  new RegExp('\\b(apple)\\b', 'i'),
  /\b(thereof)\b/ ]

The annotation function receives the form in which a RegExp was found, its path within the overall form, the RegExp that matches, and the match data from RegeExp.prototype.exec. It must return a Common Form Annotations.

function message(form, path, expression, match) {
  var word = match[1]
  return {
    message: (
      match[1] === 'apple' ?
        ( '"' + word + '" is fruity' ) :
        ( '"' + word + '" is archaic' ) ),
    path: path,
    source: 'example-annotator',
    url: null } }

var reAnnotator = require('commonform-regexp-annotator')

var annotator = reAnnotator(expressions, message)

The library does the job of finding matches and calculating paths.

var assert = require('assert')

assert.deepEqual(
  annotator({ content: [ 'Drop that apple and the stem thereof!' ] }),
  [ { message: '"apple" is fruity',
      path: [ 'content', 0 ],
      source: 'example-annotator',
      url: null },
    { message: '"thereof" is archaic',
      path: [ 'content', 0 ],
      source: 'example-annotator',
      url: null } ])