po-parser

Parses and serializes .po file content.

Zero-dependency. ~4kb minified.

Usage

Parse

import POParser from 'po-parser';

const content = `
msgid ""
msgstr ""
"POT-Creation-Date: 2025-10-27 16:00+0000\n"

#: src/Greeting.tsx
#. Greets the user
msgid "+YJVTi"
msgstr "Hey"
`;

const result = POParser.parse(content);

Serialize

import POParser from 'po-parser';

const catalog = {
  meta: {
    'POT-Creation-Date': '2025-10-27 16:00+0000'
  },
  messages: [
    {
      id: '+YJVTi',
      message: 'Hey',
      description: 'Greets the user',
      references: [{path: 'src/Greeting.tsx'}]
    }
  ]
};

const result = POParser.serialize(catalog);

Supported features

• msgid and msgstr (message entries)
• msgctxt (message context for namespacing)
• References (#: comments)
• Extracted comments (#. comments, used as descriptions)
• Flag comments (#, comments, e.g. #, fuzzy)
• Metadata (from empty msgid/msgstr entry at the beginning)
• Single-line quoted strings

Unsupported features

• Translator comments (# comments)
• Previous string key comments (#| comments)
• Plural forms (msgid_plural)
• Multi-line strings