The type of relation involved, such as "m.annotation", "m.reference", "m.replace", etc.
The relation event's type, such as "m.reaction", etc.
The client which created this instance. For backwards compatibility also accepts a Room.
Optional
altEventTypes: string[]alt event types for relation events, for example to support unstable prefixed event types
Optional
Readonly
altalt event types for relation events, for example to support unstable prefixed event types
Private
annotationsPrivate
annotationsPrivate
Readonly
clientPrivate
creationReadonly
eventThe relation event's type, such as "m.reaction", etc.
Private
relationReadonly
relationThe type of relation involved, such as "m.annotation", "m.reference", "m.replace", etc.
Private
relationsPrivate
sortedPrivate
targetPrivate
addAdd relation events to this collection.
The new relation event to be added.
Alias for TypedEventEmitter#on.
Synchronously calls each of the listeners registered for the event named
event
, in the order they were registered, passing the supplied arguments
to each.
The name of the event to emit
Rest
...args: Parameters<EventHandlerMap[T]>Arguments to pass to the listener
true
if the event had listeners, false
otherwise.
Rest
...args: Parameters<EventHandlerMap[T]>Similar to emit
but calls all listeners within a Promise.all
and returns the promise chain
The name of the event to emit
Rest
...args: Parameters<EventHandlerMap[T]>Arguments to pass to the listener
true
if the event had listeners, false
otherwise.
Rest
...args: Parameters<EventHandlerMap[T]>Get all events in this collection grouped by sender.
This is currently only supported for the annotation relation type.
An object with each relation sender as a key and the matching Set of events for that sender as a value.
Returns the most recent (and allowed) m.replace relation, if any.
This is currently only supported for the m.replace relation type,
once the target event is known, see addEvent
.
Get all relation events in this collection.
These are currently in the order of insertion to this collection, which
won't match timeline order in the case of scrollback.
TODO: Tweak addEvent
to insert correctly for scrollback.
Relation events in insertion order.
Get all events in this collection grouped by key and sorted by descending event count in each group.
This is currently only supported for the annotation relation type.
An array of [key, events] pairs sorted by descending event count. The events are stored in a Set (which preserves insertion order).
Returns the number of listeners listening to the event named event
.
The name of the event being listened for
Returns a copy of the array of listeners for the event named event
.
Private
maybeAlias for TypedEventEmitter#removeListener
Adds the listener
function to the end of the listeners array for the
event named event
.
No checks are made to see if the listener
has already been added. Multiple calls
passing the same combination of event
and listener
will result in the listener
being added, and called, multiple times.
By default, event listeners are invoked in the order they are added. The TypedEventEmitter#prependListener method can be used as an alternative to add the event listener to the beginning of the listeners array.
The name of the event.
The callback function
a reference to the EventEmitter
, so that calls can be chained.
Private
onFor relations that have been redacted, we want to remove them from aggregation data sets and emit an update event.
To do so, we listen for Event.beforeRedaction
, which happens:
The original relation event that is about to be redacted.
Private
onListens for event status changes to remove cancelled events.
The event whose status has changed
The new status
Adds a one-time listener
function for the event named event
. The
next time event
is triggered, this listener is removed and then invoked.
Returns a reference to the EventEmitter
, so that calls can be chained.
By default, event listeners are invoked in the order they are added. The TypedEventEmitter#prependOnceListener method can be used as an alternative to add the event listener to the beginning of the listeners array.
The name of the event.
The callback function
a reference to the EventEmitter
, so that calls can be chained.
Adds the listener
function to the beginning of the listeners array for the
event named event
.
No checks are made to see if the listener
has already been added. Multiple calls
passing the same combination of event
and listener
will result in the listener
being added, and called, multiple times.
The name of the event.
The callback function
a reference to the EventEmitter
, so that calls can be chained.
Adds a one-timelistener
function for the event named event
to the beginning of the listeners array.
The next time event
is triggered, this listener is removed, and then invoked.
The name of the event.
The callback function
a reference to the EventEmitter
, so that calls can be chained.
Returns a copy of the array of listeners for the event named eventName
,
including any wrappers (such as those created by .once()
).
Removes all listeners, or those of the specified event
.
It is bad practice to remove listeners added elsewhere in the code,
particularly when the EventEmitter
instance was created by some other
component or module (e.g. sockets or file streams).
Optional
event: EventEmitterEvents | RelationsEventThe name of the event. If undefined, all listeners everywhere are removed.
a reference to the EventEmitter
, so that calls can be chained.
Private
removeRemove relation event from this collection.
The relation event to remove.
Removes the specified listener
from the listener array for the event named event
.
a reference to the EventEmitter
, so that calls can be chained.
Generated using TypeDoc
A container for relation events that supports easy access to common ways of aggregating such events. Each instance holds events that of a single relation type and event type. All of the events also relate to the same original event.
The typical way to get one of these containers is via EventTimelineSet#getRelationsForEvent.