# skip-regex

> Micro parser for detection of literal regexes

Latest version **1.0.2** (published 2018-12-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install skip-regex
pnpm add skip-regex
yarn add skip-regex
bun add skip-regex
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2018-12-24 |
| First published | 2017-06-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=4.2 |
| Dependencies | 0 |
| Unpacked size | 24.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | aMarCruz |
| Maintainers | amarcruz |
| Keywords | javascript, typescript, es6, micro, parser, detection, regex, regexp |

## Links

- npm: https://www.npmjs.com/package/skip-regex
- Repository: https://github.com/aMarCruz/skip-regex
- Issues: https://github.com/aMarCruz/skip-regex/issues
- npm.io page: https://npm.io/package/skip-regex

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 1.0.2 (latest) — 2018-12-24
- 1.0.1 — 2018-12-21
- 0.3.1 — 2017-10-19
- 0.3.0 — 2017-07-04
- 0.2.0 — 2017-06-22

## README

# skipRegex

[![npm Version][npm-badge]][npm-url]
[![License][license-badge]][license-url]
[![Build Status][travis-badge]][travis-url]
[![Coverage][codecov-badge]][codecov-url]
[![Minified Size][size-badge]][size-url]

Micro parser for detection of literal regexes.

- Fast detection with high accuracy.
- Minimum size.
- Compatible with NodeJS, bundlers, IE9+, and modern Browsers.
- TypeScript definition.
- Zero dependencies.

## Install

```bash
npm install skip-regex --save
# or
yarn add skip-regex
```

or load the global `skipRegex` function in your browser:

```html
<script src="https://unpkg.com/skip-regex/index.min.js"></script>
```

Three formats transpiled to ES5:

- CommonJS for node.js and browserify-like bundlers.
- ESM for bundlers like [Rollup](https://github.com/rollup/rollup).
- UMD for AMD, CommonJS, and browsers.

## Syntax

```ts
skipRegex(source: string, start: number) => number
```

The `start` position _must_ point to a slash within `source`.

From there, `skipRegex` will find the end of a regular expression in the given string.

The returned value is the position of the character following the regex, or `start+1` if the slash does not start a regex.

## Example

This is a silly example, but it will give the idea.

```js
import skipRegex from 'skip-regex'

const source = ' /.*/ '
const start  = source.indexOf('/')

if (~start) {
  const end = skipRegex(source, start)

  if (end > start + 1) {      // detected as regex?
    const regex = source.slice(start, end)
    console.log(`Found regex ${regex} at position ${start}!`)

  } else if (source[end] === '*' || source[end] === '/') {
    console.log('The slash starts a JS comment.')

  } else {
    console.log('The slash is a division sign.')
  }
}
```

For something more complete see the [js-cleanup](https://github.com/aMarCruz/js-cleanup) code, an utility to clean comments safely in JS-like sources, which uses skip-regex to skip regular expressions.

For Rollup, you can use [rollup-plugin-node-resolve](https://github.com/rollup/rollup-plugin-node-resolve) to resolve 'skip-regex' as an ES6 module.

For TypeScript, enable `esModuleInterop` in your tsconfig.json _or_ use the `"import=require"` syntax:

```ts
import skipRegex = require('skip-regex')

//...
```

## Related Links

Some sites and tools that have been helpful:

- [RegExp (Regular Expressions) Objects](https://www.ecma-international.org/ecma-262/9.0/index.html#sec-regexp-regular-expression-objects) : ECMA Specs
- [RegExp on MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp) : MDN Reference
- [RegEgg](http://www.rexegg.com/) : Complete tutorial, various regex dialects
- [RegExr](https://regexr.com/) : Online tool for learn and test regexes
- [RegExp Preview and Editor](https://marketplace.visualstudio.com/items?itemName=le0zh.vscode-regexp-preivew) : VSCode extension based on regexper-static

## Support my Work

I'm a full-stack developer with more than 20 year of experience and I try to share most of my work for free and help others, but this takes a significant amount of time and effort so, if you like my work, please consider...

<!-- markdownlint-disable MD033 -->
[<img src="https://amarcruz.github.io/images/kofi_blue.png" height="36" title="Support Me on Ko-fi" />][kofi-url]
<!-- markdownlint-enable MD033 -->

Of course, feedback, PRs, and stars are also welcome 🙃

Thanks for your support!

## Licence

The [MIT license](LICENSE) (MIT)

&copy; 2018 Alberto Martínez

[npm-badge]:      https://badgen.net/npm/v/skip-regex
[npm-url]:        https://www.npmjs.com/package/skip-regex
[license-badge]:  https://badgen.net/npm/license/skip-regex
[license-url]:    https://github.com/aMarCruz/skip-regex/blob/master/LICENSE
[travis-badge]:   https://travis-ci.org/aMarCruz/skip-regex.svg?branch=master
[travis-url]:     https://travis-ci.org/aMarCruz/skip-regex
[codecov-badge]:  https://codecov.io/gh/aMarCruz/skip-regex/branch/master/graph/badge.svg
[codecov-url]:    https://codecov.io/gh/aMarCruz/skip-regex
[size-badge]:     https://badgen.net/bundlephobia/min/skip-regex
[size-url]:       https://bundlephobia.com/result?p=skip-regex
[kofi-url]:       https://ko-fi.com/C0C7LF7I

---
_Source: https://npm.io/package/skip-regex · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._