EO TranslatorJSTranslate web content with a dictionary

Define a dictionary, create a translator, and translate a string, a single element or a whole DOM tree in one call. Lightweight, zero-dependency, and typed.

Get Started

API Reference

Demos

📖
One dictionary, every language
Keep every translation in a plain object keyed by language, and switch the active language at any time.
🌳
Nested keys
Organise translations into namespaces and reach them with dot-separated keys such as nav.home.
🧩
Interpolation
Fill {placeholder} tokens from parameters, in code or straight from an eo-translator-params attribute.
🖥️
Translate the DOM
Mark elements with eo-translator attributes and translate one element or a whole container, as text or as HTML.
🛟
Safe fallbacks
Missing keys and languages fall back to the key itself or to a fallback you choose, never to an error.
🌍
Browser and server
Translate strings in Node.js and pages in the browser with the same dictionary. DOM methods are safe no-ops where there is no document.
🔷
TypeScript-first
Written in TypeScript, with ESM and CommonJS builds, type declarations and browser bundles for a plain script tag.
🧪
Tested end to end
Every line of the library is covered by unit tests and checked by mutation testing, and Playwright runs every demo in a real browser.

EO TranslatorJSTranslate web content with a dictionary

One dictionary, every language

Nested keys

Interpolation

Translate the DOM

Safe fallbacks

Browser and server

TypeScript-first

Tested end to end