events

package
v3.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 13, 2026 License: MIT, MIT Imports: 1 Imported by: 1

Documentation

Overview

Source: https://github.com/kataras/go-events Package events provides simple EventEmitter support for Go Programming Language

Index

Examples

Constants

View Source
const (
	// Version current version number
	EventVersion = types.EventVersion
)

Variables

This section is empty.

Functions

func AddListener

func AddListener(evt EventName, listeners ...EventListener) error

AddListener adds listeners to the default event emitter

func Clear

func Clear()

Clear removes all listeners and events

func Emit

func Emit(evt EventName, data ...any)

Emit triggers an event on the default event emitter

func Len

func Len() int

Len returns the total number of events currently registered

func ListenerCount

func ListenerCount(evt EventName) int

ListenerCount returns the number of listeners for an event

func On

func On(evt EventName, listeners ...EventListener) error

On is an alias for AddListener

func Once

func Once(evt EventName, listeners ...EventListener) error

Once adds a one-time listener to the event emitter

func RemoveAllListeners

func RemoveAllListeners(evt EventName) bool

RemoveAllListeners removes all listeners for an event

func RemoveListener

func RemoveListener(evt EventName, listener EventListener) bool

RemoveListener removes a listener from the event emitter

Types

type EventEmitter

type EventEmitter = types.EventEmitter

EventEmitter is the message/or/event manager

func NewEventEmitter

func NewEventEmitter() EventEmitter

New returns a new, empty, EventEmitter

type EventListener

type EventListener = types.EventListener

Listener is the type of a Listener, it's a func which receives any,optional, arguments from the caller/emmiter

func Listeners

func Listeners(evt EventName) []EventListener

Listeners returns all the listeners for an event

type EventName

type EventName = types.EventName

EventName is just a type of string, it's the event name

func EventNames

func EventNames() []EventName

EventNames returns all the event names

type Events

type Events = types.Events

Events the type for registered listeners, it's just a map[string][]func(...any)

Example
// regiter our events to the default event emmiter
for evt, listeners := range testEvents {
	_ = _event.On(evt, listeners...)
}

user := "user1"
room := "room1"

createUser(user)
joinUserTo(user, room)
leaveFromRoom(user, room)
Output:
A new User just created!
A new User just created, *from second event listener
user1 joined to room: room1
user1 left from the room: room1

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL