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

πŸ“₯ β€’ 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
hearts Get a random heart
foods Get a random food
circles Get a random circle
new 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

🀝 β€’ Help

Need assistance or have questions about this module? Don't hesitate to open a new Issue on our GitHub repository. Our community is ready to help and provide answers to your inquiries.

⭐ β€’ Thank you

If you use the Random Emoji module and appreciate my work, I'd be grateful if you could give it a star on our GitHub page. Your support helps me continue to develop this project and provide new and fun emojis to every user.

πŸŽ“ β€’ MIT License

Copyright 2022-2024 Β© by Sefinek. All Rights Reserved.