@lingui/message-utils

What is @lingui/message-utils?

@lingui/message-utils is a utility package for handling message formatting and manipulation in internationalization (i18n) contexts. It provides tools for parsing, formatting, and managing messages, making it easier to work with translations and localized content.

What are @lingui/message-utils's main functionalities?

Message Parsing

This feature allows you to parse a message string into an abstract syntax tree (AST). The parsed message can then be manipulated or analyzed programmatically.

const { parse } = require('@lingui/message-utils');
const message = 'Hello, {name}!';
const parsedMessage = parse(message);
console.log(parsedMessage);

Message Formatting

This feature allows you to format a message string by replacing placeholders with actual values. It is useful for generating localized content dynamically.

const { format } = require('@lingui/message-utils');
const message = 'Hello, {name}!';
const values = { name: 'John' };
const formattedMessage = format(message, values);
console.log(formattedMessage);

Message Validation

This feature allows you to validate a message string to ensure it conforms to the expected format. It helps in catching errors in message templates early.

const { validate } = require('@lingui/message-utils');
const message = 'Hello, {name}!';
const isValid = validate(message);
console.log(isValid);

Other packages similar to @lingui/message-utils

intl-messageformat

intl-messageformat is a package for formatting ICU MessageFormat strings. It provides similar functionality for parsing and formatting messages, but it is more focused on the ICU MessageFormat standard, which is widely used in internationalization.

messageformat

messageformat is another package for handling ICU MessageFormat strings. It offers a comprehensive set of tools for parsing, compiling, and formatting messages. Compared to @lingui/message-utils, it has a broader focus on the ICU MessageFormat standard and includes additional features like pluralization and gender support.

i18next

i18next is a full-featured internationalization framework for JavaScript. While it provides message formatting capabilities, it also includes a wide range of other i18n features such as language detection, interpolation, and resource management. It is more comprehensive compared to @lingui/message-utils, which is more focused on message utilities.

README

@lingui/message-utils

Internal package. You probably don't need to use it directly.

@lingui/message-utils is part of LinguiJS. See the documentation for all information, tutorials and examples.

License

MIT

Changelog

4.2.1 (2023-06-07)

Bug Fixes

• core: don't crash on escaped unicode symbols in messages (#1692) (461c2fc)
• extractor: support jsx in js files (#1678) (e335458)