https://github.com/vtex/msk
Small library to mask strings
https://github.com/vtex/msk
srv-my-account xp-post-purchase
Last synced: 11 months ago
JSON representation
Small library to mask strings
- Host: GitHub
- URL: https://github.com/vtex/msk
- Owner: vtex
- Created: 2017-07-05T21:59:04.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-07-11T13:23:21.000Z (over 2 years ago)
- Last Synced: 2025-03-27T22:39:17.777Z (12 months ago)
- Topics: srv-my-account, xp-post-purchase
- Language: JavaScript
- Size: 453 KB
- Stars: 24
- Watchers: 155
- Forks: 3
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# msk [](https://travis-ci.org/vtex/msk)
> Small library to mask strings
## Install
```sh
$ npm install msk
```
## Usage
```js
const msk = require("msk");
msk("552122222222", "+99 (99) 9999-9999")
// "+55 (21) 2222-2222"
msk.fit("22231-0004131", "99999-999")
// "22231-000"
```
## API
### msk(str, mask)
Returns a formatted string based on the mask prodived
#### str
Type: `string`
A string to apply the mask.
#### mask
Type: `string`
A mask is formed based on the following symbols:
Symbol | Accepts
---|---
`9` | Numbers (`[0-9]`)
`A` | Letters (`[A-ú]`)
`S` | Alphanumeric chars (`[A-ú0-9]`)
`*` | Anything
other char | Specified char
### msk.fit(str, mask)
Returns a formatted string removing the exceeding characters.
## Examples
```js
msk("552122222222", "+99 (99) 9999-9999")
// "+55 (21) 2222-2222"
```
```js
msk("V6G1C9", "A9A 9A9")
// "V6G 1C9"
```
```js
msk("I love msk", "*-****-***")
// "I-love-msk"
```
```js
msk.fit("22231-0004131", "99999-999")
// "22231-000"
```
## License
MIT © [VTEX](https://www.vtex.com)