📜 mask-any-number

A lightweight, flexible number-masking library — supports multiple mask patterns and automatically picks the best fit based on the input length.

🔧 Installation

npm install mask-any-number

or

yarn add mask-any-number

🌍 Country Phone Masks (built-in)

import { maskNumber, countries } from 'mask-any-number';

// Germany 🇩🇪
maskNumber('493012345678', countries.find(country => country.iso2 === 'DE').masks); 
// "[phone]"

// Brazil 🇧🇷
maskNumber('5511998765432', countries.find(country => country.iso2 === 'BR').masks); 
// "[phone]"

// US 🇺🇸
maskNumber('1234567890', countries.find(country => country.iso2 === 'US').masks); 
// "[phone]"

🎨 Custom Masks

import { maskNumber } from 'mask-any-number';

// Basic usage
maskNumber('1234567890', ['000-000-0000']); // "123-456-7890"

// Multiple masks, chooses first that fits
maskNumber('12345', ['000-000', '00000']); // "12345"
maskNumber('123456', ['000-000', '00000']); // "123-456"

### Phone Numbers
// US: (XXX) XXX-XXXX
maskNumber('1234567890', ['[phone]']); // "[phone]"

// Europe (DE): +49 XX XXXX XXXX
maskNumber('493012345678', ['[phone]']); // "[phone]"

// China: [phone]
maskNumber('861012345678', ['[phone]']); // "[phone]"

⚙️ API

Parameter	Type	Description
value	string	Input numeric string to mask
masks	string[]	Array of mask patterns using 0 as digit placeholder

Return: string — formatted number according to the first mask that fits.

🔁 Visual Summary

Type	Input	Mask	Output
US Phone	1234567890	[phone]	[phone]
EU Phone	493012345678	[phone]	[phone]
CN Phone	861012345678	[phone]	[phone]

🧪 Testing with Mock Data

const examples = [
    { value: '1234567890', masks: ['000-000-0000'] },
    { value: '31122025', masks: ['00/00/0000'] },
];

examples.forEach(({ value, masks }) => {
    console.log(maskNumber(value, masks));
});

💡 Tips

Use multiple masks to handle variable-length numbers.

Keep 0 as the digit placeholder; all other characters are treated as literals.

Ideal for phone numbers, dates, IDs, and other numeric inputs.

For local development:

Inside the library folder

npm run build

npm link

💡 Tips

Use multiple masks to handle variable-length numbers.

Keep 0 as the digit placeholder; all other characters are treated as literals.

Ideal for phone numbers, dates, IDs, and other numeric inputs.

For local development:

Inside the library folder

npm run build

npm link

npm link mask-any-number

⚠️ After the initial link, you only need to run npm run build when updating the library.

Gabriel GitHub

🧾 License

MIT © 2025