Do you have any questions or want to receive notifications about important changes or new features in my repositories? Join my Discord server! If you don't use Discord, you can also open an issue on GitHub.

The project is released under the MIT license — you can do whatever you want with it.
If you like this repository, leave a star ⭐. Thank you!

📥 • Installation

npm install @sefinek/random-emoji

😻 • Usage

| Function | Description | |-----------------------------------------------------------------------------|-------------------------------------------------------------| | unicode | Get a single emoji | | emojis | Get a random emoji with its name and type | | cats | Get a random cat emoji | | hearts | Get a random heart emoji | | foods | Get a random food emoji | | circles | Get a random circle emoji | | squares | Get a random square emoji | | Kaomojis | Get random kaomojis from the API |

😼 • Examples

const random = require('@sefinek/random-emoji');

// 1. A single emoji
console.log(random.unicode()); // 🥰

// 2. Random emoji along with its visual representation, name, and category
const emoji = random.emojis();
console.log(`Emoji: ${emoji.content}; Name: ${emoji.name}; Type: ${emoji.type}`);
// Emoji: 🐶; Name: Dog Face; Type: animal

// 3. Random cat
const cat = random.cats();
console.log(`Emoji: ${cat.content}; Name: ${cat.name}`);
// Emoji: 😺; Name: smiley_cat

⛩️ • Kaomojis

» Async/await example

const random = require('@sefinek/random-emoji');

(async () => {
    const kaomoji = new random.Kaomojis();

    const uwu = await kaomoji.uwu();
    console.log('Random UwU:', uwu.message);
})();

» Promise example

const random = require('@sefinek/random-emoji');
const kaomoji = new random.Kaomojis();

kaomoji.uwu().then(data => console.log(data));
// or shorter
kaomoji.uwu().then(console.log);

» The returned object from API

{
  "success": true,
  "status": 200,
  "info": {
    "category": "kaomoji",
    "endpoint": "uwu"
  },
  "message": "ＵｗＵ"
}

» Kaomoji endpoints

| Function | Link to the API | Version | Example | |----------|:----------------------------------------------------------|:--------|-----------| | cat() | Click here | v2 | (=^-ω-^=) | | dog() | Click here | v2 | ଘ(∪・ﻌ・∪)ଓ | | owo() | Click here | v2 | 𝓞𝔀𝓞 | | uwu() | Click here | v2 | 𝕌𝕨𝕌 | | love() | Click here | v2 | ヽ(♡‿♡)ノ |

📝 • Changelog

Click here