Class Relations

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.

Hierarchy (view full)

Constructors

  • Parameters

    • relationType: string

      The type of relation involved, such as "m.annotation", "m.reference", "m.replace", etc.

    • eventType: string

      The relation event's type, such as "m.reaction", etc.

    • client: Room | MatrixClient

      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

    Returns Relations

Properties

altEventTypes?: string[]

alt event types for relation events, for example to support unstable prefixed event types

annotationsByKey: Record<string, Set<MatrixEvent>> = {}
annotationsBySender: Record<string, Set<MatrixEvent>> = {}
client: MatrixClient
creationEmitted: boolean = false
eventType: string

The relation event's type, such as "m.reaction", etc.

relationEventIds: Set<string> = ...
relationType: string

The type of relation involved, such as "m.annotation", "m.reference", "m.replace", etc.

relations: Set<MatrixEvent> = ...
sortedAnnotationsByKey: [string, Set<MatrixEvent>][] = []
targetEvent: null | MatrixEvent = null

Methods

  • 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 null | Record<string, Set<MatrixEvent>>

  • 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.

    Returns MatrixEvent[]

  • 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 null | [string, Set<MatrixEvent>][]

  • 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.

    Type Parameters

    Parameters

    Returns this

    a reference to the EventEmitter, so that calls can be chained.

  • For 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:

    • after the server accepted the redaction and remote echoed back to us
    • before the original event has been marked redacted in the client

    Parameters

    • redactedEvent: MatrixEvent

      The original relation event that is about to be redacted.

    Returns Promise<void>

  • Listens for event status changes to remove cancelled events.

    Parameters

    Returns void

  • 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).

    Parameters

    Returns this

    a reference to the EventEmitter, so that calls can be chained.

Generated using TypeDoc