text-finder

text-finder Search "registered words" in string. Word registering is easy, and search is fast.

Install

npm install text-finder

Usage

simple

const textfinder = require('text-finder');

(async () => {
  // setup is async. (return Promise<void>)
  await textfinder.setup(['apple', 'orange', 'remon']);
  
  const result = textfinder.findOne('I like orange');
  // result: {string: 'orange', start: 7, end: 13}
})();

customize character mapping

"character mapping" means Translate as a other character.

ex) lower/upper case(A => a)

const {TextFinder} = require('./');
const textfinder = new TextFinder({A: 'a', O: 'o', R: 'r'});

(async () => {
  await textfinder.setup(['apple', 'orange', 'remon']);
  
  const result = textfinder.findOne('I like Remon');
  // result: {string: 'Remon', start: 7, end: 12}
})();

APIs

TextFinder#findOne

Returns the first word found.

const result = textfinder.findOne('I like orange and remon.');
// result: {string: 'orange', start: 7, end: 13}

TextFinder#find

Return the all word found as an array.

const result = textfinder.find('I like orange and remon.');
// result: [{string: 'orange', start: 7, end: 13}, {string: 'remon', start, 18, end: 23}]

Benchmark

| function | 100words | 1000words | 10000words | |----------|----------|-----------|------------| | Array#indexOf | 54,045 ops/s | 9,600 ops/s | 1,015 ops/s | | TextFinder#findOne | 28,787 ops/s | 24,683 ops/s | 12,858 ops/s | | TextFinder#find | 28,891 ops/s | 24,301 ops/s | 12,506 ops/s |

LICENSE

MIT LICENSE LICENSE