# arc-reg-exp

> Convenience subclass to the native RegExp object

Latest version **3.0.0** (published 2025-10-22) · ISC license · 0 weekly downloads

## Install

```sh
npm install arc-reg-exp
pnpm add arc-reg-exp
yarn add arc-reg-exp
bun add arc-reg-exp
```

## Health

**Score 60/100 (C)** — status: stable.

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

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2025-10-22 |
| First published | 2017-05-07 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 13.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Ian Reid |
| Maintainers | anyuzer |
| Keywords | RegExp, regular, expression, arc |

## Links

- npm: https://www.npmjs.com/package/arc-reg-exp
- Repository: https://github.com/anyuzer/arc-reg-exp
- Homepage: https://github.com/anyuzer/arc-reg-exp#readme
- Issues: https://github.com/anyuzer/arc-reg-exp/issues
- npm.io page: https://npm.io/package/arc-reg-exp

## Dependencies (1)

- [arc-is](https://npm.io/package/arc-is.md) ^2.1.0

## Alternatives

- [lodash.startswith](https://npm.io/package/lodash.startswith.md) — 769.7K weekly downloads
- [@tarojs/service](https://npm.io/package/@tarojs/service.md) — 33.9K weekly downloads
- [io.extendreality.tilia.indicators.spatialtargets.unity](https://npm.io/package/io.extendreality.tilia.indicators.spatialtargets.unity.md) — 131 weekly downloads
- [@rtarojs/taro](https://npm.io/package/@rtarojs/taro.md) — 90 weekly downloads
- [node-branch-io](https://npm.io/package/node-branch-io.md) — 50 weekly downloads

## Recent versions

- 3.0.0 (latest) — 2025-10-22
- 2.0.0 — 2022-11-04
- 1.0.1 — 2022-03-07
- 1.0.0 — 2017-05-07

## README

# arc-reg-exp
A RegExp convenience subclass for javascript (ES6)

## Install
```
$ npm install arc-reg-exp --save
```

## Features
* matchAll()
* matchAndReplace()
* replaceCallback()

## Basic Usage
In native RegExp when using the g modifier, you cannot easily do subgroup captures.

In this way the following pattern `/h([^o]{3}o)/g` when matched against a string `hello world, hallo world, happo world` would return `[hello, hallo, happo]` but not `[[hello,ell],[hallo,all],[happo,app]]`

This convenience class allows that behavior, as well as builds on it to do replacement behavior, and callback behavior while capturing all data. This can be convenient for simple tokenization, or a few other cases.

**NOTE: These methods have been tested against reasonable, small string evaluation cases and may not be suitable for larger tasks.**

```js
const ArcRegExp = require('arc-reg-exp');

//We use the same constructor signatures as RegExp
let ARX = new ArcRegExp(/\/:([^\/]*)/);
const params = {
    key:'cats',
    val:'2'
};

//In the case of replaceCallback we will be called with a full match array on every isolated match
const result = ARX.replaceCallback('/pets/:key/:val',([match,group])=>{
    return `/${params[group]}`;
});

console.log(result.replaced); //Should return /pets/cats/2
console.log(result.matches); //Should be [['/:key','key'],['/:val','val']]
```

## API

### new ArcRegExp([See RegExp Signature])
Create a new `ArcRegExp` object. Requires `new`

### .matchAll(searchString:String)
Search for matches in a string, and return an array of match arrays back

### .matchAndReplace(searchString:String [, replaceString:String, limit:Number])
Accept a search string, as well as 2 optional args, replaceString which will default to `''` in the event none is passed in and limit which will not apply if not passed in.

Search for matches, replace with the replaceString for as many times until limit is met, or until no more matches are found in the case of no limit being set.

Returns an object of `{replaced, matches}`

### .replaceCallback(searchString:String,callback:Function)

Accept a search string, as well as a callback function. On every match, call the callback passing in the full match array and replacing the found value with the return value of the callback.

Returns an object of `{replaced, matches}`

## Testing
```
npm test
```

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