Sha256: 50174cdb3a5beb63e26bea0d0a3a780369af68af538c60bba8beceaf03252a96

Contents?: true

Size: 1.53 KB

Versions: 39

Compression:

Stored size: 1.53 KB

Contents

# safe-regex

detect potentially
[catastrophic](http://regular-expressions.mobi/catastrophic.html)
[exponential-time](http://perlgeek.de/blog-en/perl-tips/in-search-of-an-exponetial-regexp.html)
regular expressions by limiting the
[star height](https://en.wikipedia.org/wiki/Star_height) to 1

WARNING: This module merely *seems* to work given all the catastrophic regular
expressions I could find scouring the internet, but I don't have enough of a
background in automata to be absolutely sure that this module will catch all
exponential-time cases.

[![browser support](https://ci.testling.com/substack/safe-regex.png)](https://ci.testling.com/substack/safe-regex)

[![build status](https://secure.travis-ci.org/substack/safe-regex.png)](http://travis-ci.org/substack/safe-regex)

# example

``` js
var safe = require('safe-regex');
var regex = process.argv.slice(2).join(' ');
console.log(safe(regex));
```

```
$ node safe.js '(x+x+)+y'
false
$ node safe.js '(beep|boop)*'
true
$ node safe.js '(a+){10}'
false
$ node safe.js '\blocation\s*:[^:\n]+\b(Oakland|San Francisco)\b'
true
```

# methods

``` js
var safe = require('safe-regex')
```

## var ok = safe(re, opts={})

Return a boolean `ok` whether or not the regex `re` is safe and not possibly
catastrophic.

`re` can be a `RegExp` object or just a string.

If the `re` is a string and is an invalid regex, returns `false`.

* `opts.limit` - maximum number of allowed repetitions in the entire regex.
Default: `25`.

# install

With [npm](https://npmjs.org) do:

```
npm install safe-regex
```

# license

MIT

Version data entries

39 entries across 38 versions & 12 rubygems

Version Path
optimacms-0.1.61 spec/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.18.0 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.18.2 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.16.1 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.15.2 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.18.4 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.18.1 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.12.7.pre.puma.pre.3 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.14.0 test/dummy/node_modules/safe-regex/readme.markdown
disco_app-0.13.6.pre.puma.pre.3 test/dummy/node_modules/safe-regex/readme.markdown
tang-0.2.1 spec/tang_app/node_modules/safe-regex/readme.markdown
groonga-client-model-6.0.0 test/apps/rails6.0.3.5/node_modules/safe-regex/readme.markdown
groonga-client-model-6.0.0 test/apps/rails6.1.3/node_modules/safe-regex/readme.markdown
ruby2js-4.0.4 lib/tasks/testrails/node_modules/safe-regex/readme.markdown
ruby2js-4.0.3 lib/tasks/testrails/node_modules/safe-regex/readme.markdown
tang-0.2.0 spec/tang_app/node_modules/safe-regex/readme.markdown
tang-0.1.0 spec/tang_app/node_modules/safe-regex/readme.markdown
tang-0.0.9 spec/tang_app/node_modules/safe-regex/readme.markdown
enju_library-0.3.8 spec/dummy/node_modules/safe-regex/readme.markdown
ilog-0.4.1 node_modules/safe-regex/readme.markdown