Event Listeners

Event listeners allow your bot to listen for Discord API events and execute code in response. Let’s create a simple listener that does something when the bot enters the ready state.

Create a new file in your listeners directory called client-ready.js and add the following code:

import { Listener } from 'hiei.js'

class ClientReady extends Listener {
  constructor () {
    super({
      name: 'ClientReady',
      emitter: 'client',
      event: 'ready',
      once: true
    })
  }

  run () {
    this.client.guilds.cache.each(guild => {
      console.log(`${this.client.user.username} connected to ${guild.name}`)
    })
  }
}

The name, emitter, and event parameters are required. Set once to true if you only want this listener to run once.

The ready event doesn’t return data, so the run() function has no parameters. For each guild the bot joins, we are logging a message to the console confirming the bot is connected and ready to use.

Further reading

• See all the client events you can respond to and what data they return