Detalhes do pacote

@sefinek/random-emoji

sefinek2472MIT2.1.0

A module offering a range of random emoticons, complete with their names and categories. Additionally, it also includes random kaomoji.

random, emoji, emojis, emoticon

readme (leia-me)

😻 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": "UwU"
}

» 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 2023 © by Sefinek. All Rights Reserved.

changelog (log de mudanças)

📥・v2.1.0 (20.12.2023)

🎉 Added

  1. New function <random>.squares for retrieving random squares.
  2. Added a new example (examples/table.js) demonstrating the use of module functions in a table format.

✨ Changes

  1. General code quality improvements.
  2. Enhanced type definitions in index.d.ts and expanded documentation.
  3. Improved the emoji randomization mechanism.
  4. Updated example files in the examples directory.

📥・v2.0.2/v2.0.3 (08.11.2023)

🎉 Added

  1. <random>.version

✨ Changes

  1. Removed README_PL.md.
  2. Updated add added new types to index.d.ts file.
  3. Now this module uses only native module (like https).
  4. Added new headers for better safety etc.

🌠 Migration

  1. Changed new random.kaomojis() to new random.Kaomojis().

📥・v1.4.6 (11.03.2023)

  1. Updated to v2 release of API.

📥・v1.4.5 (09.10.2022)

  1. Fixed URLs.

📥・v1.4.4 (02.10.2022)

  1. Fixed URLs.

📥・v1.4.3 (19.09.2022)

  1. Small changes in index.d.ts etc.

📥・v1.4.2 (05.06.2022)

  1. Added typings.
  2. Small fixes in README.md and README_PL.md.

📥・v1.4.1 (02.06.2022)

  1. Small changes.

📥・v1.4.0 (15.05.2022)

  1. Added new function foods() with random foods.
  2. Fixes in new kaomojis().
  3. Small fixes in README.md.
  4. Added Poland version of README.md file.

📥・v1.3.0 (13.05.2022)

  1. Updated README.md file.
  2. Added new kaomojis() with random kaomoji from my API. See examples: [1] [2]
  3. Other changes to index.js file.

📥・v1.2.0 (12.05.2022)

  1. Updated CHANGELOG.md, README.md and package.json.
  2. Added new function circles() with random circles.
  3. Removed .slashes.

📥・v1.1.1 (11.05.2022)

  1. Added new function hearts() with random hearts.

📥・v1.0.1 (08.05.2022)

  1. Added new function cats() with random cat emojis.
  2. Added CHANGELOG.md file.
  3. Changes:
     - emoji()
     + emojis()
    

📥・v0.1.0 (07.05.2022)

First release.