Skip to content

A module providing various random emoticons along with their names and types. Additionally, it also includes random kaomoji. 🐈 🐱 πŸ™€

License

Notifications You must be signed in to change notification settings

sefinek/random-emoji

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

😻 About this package 😼

Constantly supported Node.js module providing random emojis, including their names and categories. The module also offers random Japanese kaomojis.

The number of downloads Issues Last commit Commit activity Code size

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

About

A module providing various random emoticons along with their names and types. Additionally, it also includes random kaomoji. 🐈 🐱 πŸ™€

Topics

Resources

License

Stars

Watchers

Forks