Emoji have been part of our life for some time now. We use them on social media, especially in all kinds of messenger apps, where we can express our feelings in just one icon.

But sending and displaying emoji is not a simple matter for a cross-platform application. The problem is that emoji sent from mobile applications are not always displayed correctly on the web.

The latest releases of iOS and Android can support more than 1,200 emoji symbols, but the “desktop” market cannot match this range. We would like to achieve this, however, and are doing everything we can to enable our users to communicate easily on all platforms, without any restrictions on their conversations. Let me explain how we have achieved 100% support for emoji on the web.

This is how a Windows user would see a message in his or her browser without emoji:

The basic idea is that we take any emoji, determine its Unicode code and convert it to an html element which will be displayed correctly in the browser.

The theory

Let us consider 😀 (smiley face). It has the code U+1F600, and so this is how we retrieve this code using JavaScript:

'😀'.length // 2
'😀'.charCodeAt(0).toString(16) // **D83D**
'😀'.charCodeAt(1).toString(16) // **DE00**

Altogether we obtain the surrogate pair: U+D83D U+DE00.

UTF-16 encodes the symbols as a sequence of 16-bit words, allowing the symbols to be written in Unicode in the ranges from U+0000 to U+D7FF and from U+E000 to U+10FFFF (a total number of 1,112,064 codes).

If you need to represent a symbol in UTF-16 which has a code greater than U+FFFF, you have to use two words:

  • The first part of the surrogate pair (in the range from 0xD800 to 0xDBFF)
  • And the second (in the range from 0xDC00 to 0xDFFF).

The following formula is used to obtain the code for an emoji found in the range above U+FFFF:

(0xD83D - 0xD800) * 0x400 + 0xDE00 - 0xDC00 + 0x10000 = 1f600

And now to translate back:

D83D = ((0x1f600 - 0x10000) >> 10) + 0xD800;
DE00 = ((0x1f600 - 0x10000) % 0x400) + 0xDC00;

This is quite complex and inconvenient. Let’s see what ES 2015 can offer us.

With the new JavaScript standard we can forget about surrogate pairs and make our lives easier:

String.prototype.codePointAt // return codePoint from String
String.fromCodePoint // return String from codePoint

Both methods work correctly with surrogate pairs. It’s still possible to insert eight-digit codes into a string:

\u{1F466} instead of \uD83D\uDC66

RegExp.prototype.unicode: the u flag in regular expressions provides the best support when working with Unicode:


Currently, Unicode standard 8.0 contains 1,281 emoji symbols, and this doesn’t include modifiers for skin colour and groups (emoji families). Major companies have their own implementation:

Emoji can be divided into several groups:

  • Simple: in the range up to 0xD7FF — ⛄️ ;
  • Surrogate pairs: from 0xD800 to 0xDFFF — 😀 ;
  • Numbers: from 0x0023 to 0x0039 + 0x20E3 — 🔟 ;
  • National flags: 2 characters from 0xDDE6 to 0xDDFF, resulting in — 🇷🇺 ;
  • Skin colour modifiers: 👱 + from 0xDFFB to 0xDFFF — 👦🏿 ;
  • Family: sequence from 👱 👱 👩 combined 0x200D or 0x200C — 👪

Our solution

  1. We receive a source text with symbols, and search it for all emoji collections with the help of a regular expression;
  2. We determine the code for the character by using the codePointAt function;
  3. We compose an img element (important that it has the tag img) with a URL which consists of the code for this symbol;
  4. We replace the symbol with the img in the original text.
function emojiToHtml(str) {
     	str = str.replace(/\uFE0F/g, '');
     	return str.replace(emojiRegex, buildImgFromEmoji);

var tpl = '<img class="emoji emoji--{code} js-smile-insert" src="{src}" srcset="{src} 1x, {src_x2} 2x" unselectable="on">';
var url = 'https://badoocdn.com/big/chat/emoji/{code}.png';
var url2 = 'https://badoocdn.com/big/chat/emoji@x2/{code}.png';

function buildImgFromEmoji(emoji) {
     	var codePoint = extractEmojiToCodePoint(emoji);
     	return $tpl(tpl, {
              	code: codePoint,
              	src: $tpl(url, {
                       	code: codePoint
              	src_x2: $tpl(url2, {
                       	code: codePoint

function extractEmojiToCodePoint(emoji) {
     	return emoji
              	.map(function (symbol, index) {
                       	return emoji.codePointAt(index).toString(16);
              	.filter(function (codePoint) {
                       	return !isSurrogatePair(codePoint);
              	}, this)

function isSurrogatePair(codePoint) {
     	codePoint = parseInt(codePoint, 16);
     	return codePoint >= 0xD800 && codePoint <= 0xDFFF;

The basic concept for the regular expression which finds emoji symbols:

var emojiRanges = [
     	'(?:\uD83C[\uDDE6-\uDDFF]){2}', // flags
     	'[\u0023-\u0039]\u20E3', // numbers

'(?:[\uD83D\uD83C\uD83E][\uDC00-\uDFFF]|[\u270A-\u270D\u261D\u26F9])\uD83C[\uDFFB-\uDFFF]', // skin
     	'\uD83D[\uDC68\uDC69][\u200D\u200C].+?\uD83D[\uDC66-\uDC69](?![\u200D\u200C])', // joiners
     	'[\uD83D\uD83C\uD83E][\uDC00-\uDFFF]', // surrogate pair

'[\u3297\u3299\u303D\u2B50\u2B55\u2B1B\u27BF\u27A1\u24C2\u25B6\u25C0\u2600\u2705\u21AA\u21A9]', // simple

var emojiRegex = new RegExp(emojiRanges.join('|'), 'g');


Below you will see how we were able to construct a chat prototype with support for emoji.
A <div/> is used as the field for entering the message:

<div id="t" contenteditable="true" data-placeholder="Введите сообщение"></div>

We strip possible HTML tags from its content when entering the message or inserting it from the clipboard:

var tagRegex = /<[^>]+>/gim;
var styleTagRegex = /<style\b[^>]*>([\s\S]*?)<\/style>/gim;
var validTagsRegex = /<br[\s/]*>|<img\s+class="emoji\semoji[-\w\s]+"\s+((src|srcset|unselectable)="[^"]*"\s*)+>/i;

function cleanUp(text) {
     	return text
              	.replace(styleTagRegex, '')
              	.replace(tagRegex, function (tag) {
                       	return tag.match(validTagsRegex) ? tag : '';
              	.replace(/\n/g, '');

We use the paste event for processing a string inserted from the clipboard:

function onPaste(e) {
     	var clp = e.clipboardData;

     	if (clp !== undefined || window.clipboardData !== undefined) {
              	var text;

              	if (clp !== undefined) {
                       	text = clp.getData('text/html') || clp.getData('text/plain') || '';
              	} else {
                       	text = window.clipboardData.getData('text') || '';

              	if (text) {
                       	text = cleanUp(text);
                       	text = emojiToHtml(text);
                       	var el = document.createElement('span');
                       	el.innerHTML = text;
                       	el.innerHTML = el.innerHTML.replace(/\n/g, '');

Then we replace all the emoji found with the HTML tag img, as shown above. We need to use img, as ContentEditable works better with this. Bugs may occur during editing with other elements.

After inserting img in the input field, it’s necessary to restore the position so that the user can continue composing the message. We use the Selection and Range JavaScript objects for this:

function restore() {
     	var range = document.createRange();
     	var sel = window.getSelection();

Once the composition of the message is completed, we must run the reverse procedure. This means we convert the to a symbol for sending to the server using the fromCodePoint function:

var htmlToEmojiRegex = /<img.*?class="emoji\semoji--(.+?)\sjs-smile-insert".*?>/gi;
function htmlToEmoji(html) {
     	return html.replace(htmlToEmojiRegex, function (imgTag, codesStr) {
              	var codesInt = codesStr.split('-').map(function (codePoint) {
                       	return parseInt(codePoint, 16);

              	var emoji = String.fromCodePoint.apply(null, codesInt);

              	return emoji.match(emojiRegex) ? emoji : '';

You can see an example of a Chat system here: https://jsfiddle.net/q9484hcc/

And this is how we’ve have developed support for emoji that allow our users to fully express their emotion and to communicate with each other without restriction. If you have any suggestions or ideas to improve and change our methods, feel free to leave a comment below. I will be happy to look at them.

Useful links:

Artem Kunets - Badoo Frontend developer