
Product
Introducing Socket Firewall Enterprise: Flexible, Configurable Protection for Modern Package Ecosystems
Socket Firewall Enterprise is now available with flexible deployment, configurable policies, and expanded language support.
kitten-format
Advanced tools
Fast currency, number and string formatters for browsers.
npm install kitten-format
Two builds are available :
kittenFormat.client.jskittenFormat.client.min.jsLocales are not shipped with the builds. You must select the locales you want. Locales are defined in locales/.
Locale auto-register itself.
At runtime, kitten-format will try to set the default locale as the one defined by the browser.
Available locales
| Lang | Locales |
|---|---|
| Arabic (U.A.E.) | ar-AE |
| Arabic (Egypt) | ar-EG |
| Arabic (Morocco) | ar-MA |
| Arabic (Saudi Arabia) | ar-SA |
| German (Switzerland) | de-CH |
| English (United Kingdom) | en-GB |
| English (United States) | en-US |
| Spanish (Spain) | es-ES |
| Spanish (Chile) | es-CL |
| French (Switzerland) | fr-CH |
| French (France) | fr-FR |
| French (French Polynesia) | fr-PF |
| Italian (Switzerland) | it-CH |
| Italian (Italia) | it-IT |
Default is fr-FR
Set default locale options.
kittenFormat.setOptions({
locale : 'fr-FR', // default locale
currency : 'EUR', // default currency
precision : 2, // default precision
unitPrefixes : { // default unit prefixes
'15' : 'P',
'12' : 'T',
'9' : 'G',
'6' : 'M',
'3' : 'k',
'0' : '',
'-3' : 'm',
'-6' : 'ÎĽ',
'-9' : 'n'
},
isCurrencyFirst : true
});
Set a default locale option.
kittenFormat.setOption('currency', 'GBP');
Average a number to default or specified locale.
kittenFormat.averageN(1234, {
locale : 'fr-FR',
unit : 'g',
precision : 1
});
// res: '1,2 kg'
// options
{
locale : String,
precision : Int, // number of decimal value
unit : String,
power : Int // current unit,
maxPower : Int
}
kittenFormat.averageN(1234, {
locale : 'fr-FR',
unit : 'g',
precision : 2,
power : -3
});
// res: '1,23 g'
kittenFormat.averageN(1234, {
locale : 'fr-FR',
unit : 'g',
precision : 2,
power : 0,
maxPower : 0
});
// res: '1 234 g'
Format a number to default or specified locale.
kittenFormat.formatN(1234, {
locale : 'fr-FR'
});
// res: '1 234'
// options
{
locale : String,
precision : Int, // number of decimal value
minimumFractionDigits : Int,
shouldNotRound : Boolean
}
Set percentage of a number
kittenFormat.percent(0.193, {
locale : 'fr-FR'
});
// res: '19,3%'
// options
{
locale : String,
precision : Int, // number of decimal value
}
kittenFormat.percent(18.45, { isAlreadyPercentageNumber : true });
// res: '18,45%'
kittenFormat.getCurrency('USD');
// res: '$'
Format a currency to specified locale and/or currency. If convert options are specified, it makes the conversion.
kittenFormat.formatC(1234, {
locale : 'fr-FR'
});
// res: '1 234€'
// options
{
locale : String,
precision : Int, // number of decimal value
currency : String, // currency defined by ISO 4217
shouldNotRound : Boolean
}
kittenFormat.formatC(1234.45, {
locale : 'en-GB',
precision : 2,
currency : 'EUR'
});
// res: '€1,234.45'
kittenFormat.formatC(1234.45, {
locale : 'en-GB',
precision : 2,
target : 'EUR'
rates : {
EUR : 0.8,
GBP : 1
}
});
// res: '€987.56'
Convert a currency to another one
kittenFormat.convC(1234, {
locale : 'fr-FR',
source : 'EUR',
target : 'USD',
rates : { EUR : 1, USD : 1.3 }
});
// res: '1 604,2$'
// options
{
locale : String,
precision : Int, // number of decimal value
source : String, // currency defined by ISO 4217
target : String, // currency defined by ISO 4217
rates : {
'<source>' : Int,
'<target>' : Int
}
}
Average a currency to default or specified locale.
It can only average to € or k€.
kittenFormat.averageC(1234, {
locale : 'fr-FR'
});
// res: '1,2 k€'
// options
{
locale : String,
power : Int // current unit
}
Convert a string to Lowercase.
kittenFormat.lowerCase('ABC');
// res: 'abc'
Convert a string to uppercase.
kittenFormat.upperCase('abc');
// res: 'ABC'
Convert the first char of a string to uppercase.
kittenFormat.upperCaseFirstChar('abc');
// res: 'Abc'
FAQs
Fast formatters for browsers
We found that kitten-format demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Product
Socket Firewall Enterprise is now available with flexible deployment, configurable policies, and expanded language support.

Security News
Open source dashboard CNAPulse tracks CVE Numbering Authorities’ publishing activity, highlighting trends and transparency across the CVE ecosystem.

Product
Detect malware, unsafe data flows, and license issues in GitHub Actions with Socket’s new workflow scanning support.