2020-08-25 23:57:08 +00:00
|
|
|
# astral-regex [![Build Status](https://travis-ci.org/kevva/astral-regex.svg?branch=master)](https://travis-ci.org/kevva/astral-regex)
|
|
|
|
|
2021-02-26 03:58:33 +00:00
|
|
|
> Regular expression for matching [astral symbols](https://everything2.com/title/astral+plane)
|
2020-08-25 23:57:08 +00:00
|
|
|
|
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
|
|
```
|
|
|
|
$ npm install astral-regex
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```js
|
|
|
|
const astralRegex = require('astral-regex');
|
|
|
|
|
2021-02-26 03:58:33 +00:00
|
|
|
astralRegex({exact: true}).test('🦄');
|
2020-08-25 23:57:08 +00:00
|
|
|
//=> true
|
2021-02-26 03:58:33 +00:00
|
|
|
|
|
|
|
'foo 🦄 💩 bar'.match(astralRegex());
|
|
|
|
//=> ['🦄', '💩']
|
2020-08-25 23:57:08 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
### astralRegex([options])
|
|
|
|
|
|
|
|
Returns a `RegExp` for matching astral symbols.
|
|
|
|
|
|
|
|
#### options
|
|
|
|
|
|
|
|
Type: `Object`
|
|
|
|
|
|
|
|
##### exact
|
|
|
|
|
|
|
|
Type: `boolean`<br>
|
|
|
|
Default: `false` *(Matches any astral symbols in a string)*
|
|
|
|
|
|
|
|
Only match an exact string. Useful with `RegExp#test()` to check if a string is a astral symbol.
|
|
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
MIT © [Kevin Mårtensson](https://github.com/kevva)
|