node-emoji

What is node-emoji?

The node-emoji package provides a simple way to add Unicode emoji support to your Node.js applications. It allows you to easily include emoji characters in your strings and manipulate them as needed.

What are node-emoji's main functionalities?

Get emoji by name

Retrieve an emoji character using its name (alias).

const emoji = require('node-emoji');
console.log(emoji.get('coffee')); // outputs the coffee emoji

Find emoji in a string

Search for and return information about an emoji within a string.

const emoji = require('node-emoji');
console.log(emoji.find('I :heart: node-emoji!')); // finds and returns the heart emoji object

Replace emoji names with characters in a string

Convert emoji aliases in a string to their corresponding emoji characters.

const emoji = require('node-emoji');
console.log(emoji.emojify('I :heart: node-emoji!')); // replaces the :heart: alias with the actual heart emoji character

Replace characters with emoji names in a string

Convert emoji characters in a string to their corresponding emoji aliases.

const emoji = require('node-emoji');
console.log(emoji.unemojify('I ❤️ node-emoji!')); // replaces the heart emoji character with its alias :heart:

Random emoji

Get a random emoji object, which includes the emoji character and its alias.

const emoji = require('node-emoji');
console.log(emoji.random()); // returns a random emoji object

Other packages similar to node-emoji

emojione

Emojione is a package that provides emoji conversion and supports a wide range of emoji characters. It is similar to node-emoji but also includes additional features such as emoji shortcodes, ASCII conversions, and sprite generation.

emoji-js

Emoji-js is a package that allows for conversion between Unicode characters and emoji images. It differs from node-emoji in that it can convert emoji characters into images, which can be useful for web applications that need to support a wide range of devices and platforms.

twemoji

Twemoji is a Twitter open-source project that provides emoji support across different platforms. It offers emoji parsing and image conversion, similar to emoji-js, and focuses on consistent emoji rendering across all platforms.

README

node-emoji

simple emoji support for node.js projects

Installation

To install node-emoji, you need node.js and npm. :rocket:

Once you have that set-up, just run npm install --save node-emoji in your project directory. :ship:

You're now ready to use emoji in your node projects! Awesome! :metal:

Using the class

var emoji = require('node-emoji');
console.log(emoji.get('coffee')); // returns the emoji code for coffee (displays emoji on terminals that support it)
console.log(emoji.which(emoji.get('coffee'))); // returns coffee
console.log(emoji.get(':fast_forward:')); // also supports github flavored markdown emoji (http://www.emoji-cheat-sheet.com/)

Using the object

var emoji = require('node-emoji').emoji;
console.log(emoji.coffee); // returns the emoji code for coffee (displays emoji on terminals that support it)
console.log(emoji.fast_forward); // returns the emoji code for fast_forward (displays emoji on terminals that support it)

Adding new emoji

Emoji come from js-emoji (Thanks a lot :thumbsup:).

To update the list or add custom emoji, clone this repository and put them into lib/emojifile.js. Then run npm run-script emojiparse in the project directory or node emojiparse in the lib directory. This should generate the new emoji.json file and output Done..

That's all, you now have more emoji you can use! :clap: