0.0.4 • Published 8 years ago
data-mask v0.0.4
data-mask
A small string masking library in javascript.
INSTALLATION
With bower:
bower install --save data-mask
With npm:
npm install --save data-mask
USAGE
Use it by using DataMasker instance with plain text:
/**
* options parameter is optional in the constructor.
*/
var dataMasker = new DataMasker('lorem ipsum', options); //options is optional
var output = '';
output = dataMasker.maskLeft(2); //"**rem **sum"
output = dataMasker.maskRight(2); //"lor** ips**"
output = dataMasker.maskRandom(2); //"lo*e* ip**m" etc (random chars)
//options can be override on function call
output = dataMasker.maskLeft(2, ' ', '#'); //"##rem ##sum"
output = dataMasker.maskRight(2, ' ', '@'); //"lor@@ ips@@"
output = dataMasker.maskRandom(2, ' ', '-'); //"lo-e- ip--m" etc (random chars)
output = dataMasker.maskLeft(2, 4, '?'); //"??re??ip??m"" (fixed chuks)
//before & after mask functions.
output = dataMasker.maskLeft(2, ' ', '?', beforeMaskFn, afterMaskFn);
//or just call mask function
output = dataMasker.mask(2, ' ', '#', 1); //"##rem ##sum"
//also static calls available.
output = DataMasker.maskLeft('lorem ipsum', 2, ' ', '#'); //"##rem ##sum"
output = DataMasker.maskRight('lorem ipsum', 2, ' ', '@'); //"lor@@ ips@@"
output = DataMasker.maskRandom('lorem ipsum', 2, ' ', '-'); //"lo-e- ip--m" etc (random chars)
output = DataMasker.maskLeft('lorem ipsum', 2, 4, '?'); //"??re??ip??m"" (fixed chuks)
OPTIONS
Options for constructor or method params:
Option | Description |
---|---|
maskChar | An one-length string used for mask (Default * ) |
deliminator | A deliminator string or integer for fixed chunks (Default ' ' or min 1 ) |
direction | Mask positions. Left, right or random chars "1, -1, 0" (Default 1 ) |
range | Mask character count or percentage for token (0 < range < 1), range=0 is random character count. |
beforeMask | Callback function on before mask for each token. fn(token , range , maskChar , deliminator ), a string token expected. Return false for prevent masking. |
aftermask | Callback function on after mask for each token. fn(token , range , maskChar , deliminator ), a string token expected. Return false for exclude token. |
beforeMask and afterMask examples:
function beforeMask(token, range, maskChar, deliminator) {
if(token=='lorem'){
return 'LOREM'; //Uppercase 'lorem'
}
else if(token == 'ipsum'){
return false; //Not mask 'ipsum'
}
else{
return token;
}
}
function afterMask(token, range, maskChar, deliminator) {
if(token === maskChar){
return false; //Ignore one-length masked tokens like '*', '#' etc.
}
else{
return token;
}
}
LICENSE
Copyright (c) 2016 Soner Çökmen
Licensed under the MIT license.