Emoji

An emoji database.

Usage

var emoji = require( '@stdlib/datasets/emoji' );

emoji()

Returns an emoji database.

var data = emoji();
// returns [ {...}, ... ]

Each element in the returned database has the following fields:

  • group: emoji group (illustrative); e.g., 'Smileys & Emotion'.
  • subgroup: emoji subgroup (illustrative); e.g., 'face-smiling'.
  • codepoints: list of one or more hex code points, separated by spaces; e.g., '1F600'.
  • hash: hash value used to match related emoji.
  • status: indicates whether an emoji element is missing one or more emoji presentation selectors. Possible values: 'fully-qualified', 'minimally-qualified', 'unqualified'.
  • emoji: rendered emoji; e.g., '😀'.
  • short_name: CLDR short name; e.g., 'grinning face'.
  • description: short description (often matching the CLDR short name, but omitting skin tones, hair styles, et cetera).
  • aliases: an array of emoji aliases (i.e., common names used to refer to an emoji).
  • keywords: an array of keywords related to an emoji.
  • codes: an array of emoji codes (i.e., convenient character sequences used within text to refer to an emoji); e.g., ':grinning:' and ':call_me_hand::skin-tone-5:'.

In addition, for those emoji supporting skin tones, an element may have the following field:

  • skin_tones: an array of skin tone modifiers based on the Fitzpatrick scale; e.g., 'skin-tone-2'.

Examples

var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
var emoji = require( '@stdlib/datasets/emoji' );

var data;
var len;
var idx;
var d;
var i;

data = emoji();
len = data.length;

// Select random emoji...
for ( i = 0; i < 100; i++ ) {
    idx = discreteUniform( 0, len-1 );
    d = data[ idx ];
    console.log( d.emoji + ' => ' + d.codes[ 0 ] );
}

CLI

Usage

Usage: emoji [options]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.

Notes

  • Data is written to stdout as newline-delimited JSON (NDJSON).

Examples

$ emoji

License

The data files (databases) are licensed under an Open Data Commons Public Domain Dedication & License 1.0 and their contents are licensed under Creative Commons Zero v1.0 Universal. The software is licensed under Apache License, Version 2.0.

Did you find this page helpful?