@poppinss/intl-formatter

JavaScript Internationalization API, memoized for speed and performance

The @poppinss/intl-formatter package ships with the memoized version of the Intl API. Creating new instances of the new Intl.<AnyFormatter> is painfully slow (see benchmarks), and this package caches those instances for re-use.

• The API is 100% identical to the official spec, instead of writing new Intl.DateTimeFormat(), you write formatters.date(), and the rest is all the same.
• All arguments are deeply compared during memoization.

Usage

Install the package from the npm registry as follows:

npm i @poppinss/intl-formatter

# Yarn friends
yarn add @poppinss/intl-formatter

And use it as follows:

import formatters from '@poppinss/intl-formatter'

const amount = formatters
  .number('en-in', { style: 'currency', currency: 'INR' })
  .format(10)

console.log(amount)

Available formatters

• formatters.number same as Intl.NumberFormat
• formatters.date same as Intl.DateTimeFormat
• formatters.relative same as Intl.RelativeTimeFormat
• formatters.plural same as Intl.PluralRules
• formatters.list same as Intl.ListFormat
• formatters.displayNames same as Intl.DisplayNames

Why not use FormatJS?

FormatJS is a great and popular library for Internationalization. However, it has a large set of polyfills for different platforms (especially for browsers) that do not have complete support for Intl.

This package relies on the native Intl APIs available in Node.js runtime and caches the instances for re-use and performance.

Benchmarks

DateTimeFormat

DateTimeFormat@memoize x 2,192,264 ops/sec ±0.17% (99 runs sampled)
DateTimeFormat x 41,933 ops/sec ±16.93% (87 runs sampled)

Fastest is DateTimeFormat@memoize

NumberFormat

NumberFormat@memoize x 3,630,725 ops/sec ±0.87% (97 runs sampled)
NumberFormat x 88,994 ops/sec ±2.96% (93 runs sampled)

Fastest is NumberFormat@memoize

PluralRules

PluralRules@memoize x 3,296,162 ops/sec ±1.13% (98 runs sampled)
PluralRules x 80,256 ops/sec ±3.65% (82 runs sampled)

Fastest is PluralRules@memoize

RelativeTimeFormat

RelativeTimeFormat@memoize x 3,149,774 ops/sec ±1.07% (97 runs sampled)
RelativeTimeFormat x 114,421 ops/sec ±2.62% (90 runs sampled)

Fastest is RelativeTimeFormat@memoize

ListFormat

ListFormat@memoize x 1,875,493 ops/sec ±1.95% (95 runs sampled)
ListFormat x 311,985 ops/sec ±1.30% (96 runs sampled)

Fastest is ListFormat@memoize

DisplayNames

DisplayNames@memoize x 338,991 ops/sec ±0.96% (97 runs sampled)
DisplayNames x 128,909 ops/sec ±1.16% (94 runs sampled)

Fastest is DisplayNames@memoize