Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

regexp-worker

Package Overview
Dependencies
Maintainers
0
Versions
10
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

regexp-worker

Runs regular expressions on a background thread.

  • 3.0.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
255
decreased by-25.22%
Maintainers
0
Weekly downloads
 
Created
Source

Regular Expression Worker

Execute Regular Expression Matches on a Node Worker Thread.

Regular Expressions can suffer from Catastrophic Backtracking. A very simple expression like /(x+x+)+y/ can cause your JavaScript application to freeze. This library allows you to run these expressions on another thread. If they take to long to complete, they are terminated, protecting your application from locking up.

Installation

npm install regexp-worker

Basic Usage

In the example below:

  1. a new Worker thread is created
  2. the regular expression is executed on the thread
  3. the result is returned
  4. the thread is stopped

For the occasional request, this is the easiest way, but the Worker startup and shutdown is expensive.

Find the words in some text

import { execRegExpOnWorker } from 'regexp-worker'
//...
const response = await execRegExpOnWorker(/\b\w+/g, 'Good Morning')
console.log(response.matches.map(m => m[0]))

Result:

  console.log
    [ 'Good', 'Morning' ]

Find the word breaks in some text

import { execRegExpOnWorker } from 'regexp-worker'
//...
const response = await execRegExpOnWorker(/\b/g, 'Good Morning');
console.log(response.matches.map(m => m.index))

Result:

  console.log
    [ 0, 4, 5, 12 ]

Format of the response

interface ExecRegExpResult {
    elapsedTimeMs: number;
    matches: RegExpExecArray[];
}

Where RegExpExecArray is RegExp.prototype.exec() result.

Creating a RegExpWorker Instance

To reduce the cost of starting and stopping the Worker, it is possible to create a RegExpWorker instance. This instance allows you to make multiple requests using the same worker. The request are queued and handled one at a time. If a request takes too long, it is terminated and the promise is rejected with an ErrorCanceledRequest.

import { RegExpWorker } from 'regexp-worker'

// ...
const defaultTimeOutMs = 10
const worker = new RegExpWorker(defaultTimeOutMs);

// Find all words in some text
let words = await worker.execRegExp(/\b\w+/g, 'Lots of text ...')

// Find all numbers in some text
let numbers = await worker.execRegExp(/\b\d+/g, 'Lots of text ...')

// Find 3 letter word pairs
let moreTimeMs = 100
let numbers = await worker.execRegExp(/\b\w{3}\s+\w{3}/g, 'Lots of text ...', moreTimeMs)

// ...

// It is a good idea to dispose of the worker before shutdown.
// The worker thread will stop on its own if left idle for more than 200ms.
worker.dispose();

Handling Timeouts

If the request times out, the promise will be rejected with:

interface TimeoutError {
    message: string;
    elapsedTimeMs: number;
}

Keywords

FAQs

Package last updated on 03 Jul 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc