intl-messageformat-parser

What is intl-messageformat-parser?

The intl-messageformat-parser package is a tool for parsing ICU MessageFormat strings into an Abstract Syntax Tree (AST). This is useful for internationalization (i18n) as it allows developers to handle complex message formatting in a structured way.

What are intl-messageformat-parser's main functionalities?

Parsing MessageFormat Strings

This feature allows you to parse a MessageFormat string into an AST. The AST can then be used for further processing or manipulation.

const { parse } = require('intl-messageformat-parser');
const message = 'Hello, {name}! You have {numMessages, plural, one {# message} other {# messages}}.';
const ast = parse(message);
console.log(JSON.stringify(ast, null, 2));

Handling Pluralization

This feature allows you to handle pluralization in messages. The parser can interpret plural rules and convert them into an AST.

const { parse } = require('intl-messageformat-parser');
const message = '{num, plural, one {# item} other {# items}}';
const ast = parse(message);
console.log(JSON.stringify(ast, null, 2));

Handling SelectFormat

This feature allows you to handle select format in messages. The parser can interpret select rules and convert them into an AST.

const { parse } = require('intl-messageformat-parser');
const message = '{gender, select, male {He} female {She} other {They}} will respond soon.';
const ast = parse(message);
console.log(JSON.stringify(ast, null, 2));

Other packages similar to intl-messageformat-parser

messageformat

The messageformat package provides similar functionality for handling ICU MessageFormat strings. It includes both a parser and a compiler, allowing you to parse MessageFormat strings and compile them into JavaScript functions. Compared to intl-messageformat-parser, it offers a more comprehensive solution by including both parsing and compiling capabilities.

format-message

The format-message package is another tool for handling ICU MessageFormat strings. It provides a simple API for formatting messages and supports interpolation, pluralization, and select format. While it does not provide a direct AST like intl-messageformat-parser, it offers a higher-level API for message formatting.

i18next

i18next is a full-featured internationalization framework for JavaScript. It supports various types of message formatting, including ICU MessageFormat. While it is more comprehensive and includes features like language detection and translation management, it may be overkill if you only need to parse MessageFormat strings.

README

Intl MessageFormat Parser

We've migrated the docs to https://formatjs.io/docs/intl-messageformat-parser.