node-emoji provides simple emoji lookups and parsing utilities for Node.js projects, including functions to emojify and unemojify markdown-encoded emojis, find emojis by name, and replace or strip emojis in strings. It is useful when you need to parse emoji codes like `:heart:` into characters, search by keyword, or convert between names and emoji characters.
Project status
- Maintenance status: The repo appears quiet/dormant. The last upstream push was 2025-02-07, and the most recent published update shown is v2.2.0 on 2024-12-03, which is more than a year ago relative to 2026-08-12.
- Update cadence: Updates are infrequent, with gaps of roughly 1+ year between the last shown updates (v2.2.0 in late 2024, previous v2.1.x in 2023).
AI summary generated
Recent updates
v2.2.0
v2.2.0 adds new developer-facing capabilities to the emoji search/parsing utilities, most notably expanding `search` to accept RegExp inputs and enhancing `emojify` with a new formatting hook. The release notes section provided with this analysis is empty, so the actual code behavior changes need to be inferred from the diff and changelog edits. A substantial portion of the diff is tooling and CI dependency updates plus test additions.
v2.1.3
This release primarily updates the project version to 2.1.3 and changes the dependency configuration. The only functional dependency change in the diff is a downgrade of the skin-tone package, along with a Renovate bot configuration tweak.
v2.1.2
Version v2.1.2 was published on 2023-11-20, but the publisher provided no release notes. As a result, there is no documented information here about features, fixes, breaking changes, or dependency updates for this upgrade.
v2.1.0
v2.1.0 converts node-emoji from JavaScript to TypeScript, adds generated type declarations, and adjusts build tooling to compile the TS entrypoint. It also updates test/build infrastructure (tsup and Jest config) and introduces TypeScript compiler configuration for type checking.
Featuresv2.0.2
v2.0.2 is a major rewrite of node-emoji with an ESM-first codebase and a new functional API for emoji lookup, parsing, and string replacement. The release notes mention a preserveSpaces option behavior change for replace, but the diff shows broader API and behavior changes across multiple functions.
BreakingFeaturesv1.11.0
v1.11.0 focuses on updating the emoji dataset (Unicode additions, including 🍱), adjusting emoji lookup behavior in `get()` for inputs that are already emoji characters, and migrating from `lodash.toarray` to the main `lodash` package. It also bumps dependencies as part of a vulnerability fix. The release notes only call out `get()` and emoji dataset changes, but the code diff suggests additional, non-mentioned edits (notably in `lib/emojifile.js`).
SecurityFeaturesv1.10.0
Release 1.10.0 updates the bundled emoji dataset (notably emoji.json) and adjusts library behavior and tests accordingly. The release notes only mention the emoji data update, but the code diff indicates user-visible changes to the exact emoji characters returned and how some glyphs map to emoji names.
v1.9.0
Release 1.9.0 updates the project emoji dataset to the newer Emoji version (stated in the release notes as v2.5.2). The code diff shows large regenerated emoji mapping data, plus minor README and test adjustments.
Featuresv1.8.1
Release 1.8.1 adds two new APIs, Emoji.strip and Emoji.replace, for removing or replacing emojis in a string. The code also makes a small internal change to Emoji.emojify related to the on_missing callback, which is not covered by the release notes.
BreakingFeaturesv1.8.0
Release v1.8.0 refactors the library and adds new emoji lookup APIs. The documented additions are emoji.find() and emoji.hasEmoji(), plus a general refactor/performance work item.
Featuresv1.7.0
Release v1.7.0 adds a new third argument, `format`, to `emojify` so callers can wrap parsed emojis in custom markup. It also includes an improved `unemojify` implementation that changes the mapping for certain emojis.
Featuresv1.6.1
Release v1.6.1 is described as a revert of v1.6.0 due to a yarn-related breakage. However, the code diff between v1.6.0 and v1.6.1 shows substantial API and dependency removals unrelated to yarn.
Breakingv1.6.0
Release 1.6.0 primarily introduces the `unemojify` feature to convert emoji characters in a string back into their `:emoji_name:` form. The release notes only mention this implemented feature, but the code changes include additional modifications beyond the documented behavior.
BreakingFeatures