most recent error associated with sending the event, if any
The raw (possibly encrypted) event. Do not access this property directly unless you absolutely have to. Prefer the getter methods defined on this class. Using the getter methods shields your app from changes to event JSON between Matrix versions.
True if this event is 'forward looking', meaning that getDirectionalContent() will return event.content and not event.prev_content. Only state events may be backwards looking Default: true. This property is experimental and may change.
The room member who sent this event, or null e.g. this is a presence event. This is only guaranteed to be set for events that appear in a timeline, ie. do not guarantee that it will be set on state events.
The sending status of the event.
The room member who is the target of this event, e.g. the invitee, the person being banned, etc.
If we failed to decrypt this event, the reason for the failure. Otherwise, null.
True if this event is an encrypted event which we failed to decrypt, the receiver's device is unverified and the sender has disabled encrypting to unverified devices.
@deprecated: Prefer event.decryptionFailureReason === DecryptionFailureCode.MEGOLM_KEY_WITHHELD_FOR_UNVERIFIED_DEVICE.
A helper to check if an event is a thread's head or not
Get the event ID of the thread head
Alias for on.
Change the visibility of an event, as per https://github.com/matrix-org/matrix-doc/pull/3531 .
OptionalvisibilityChange: IVisibilityChangeevent holding a hide/unhide payload, or nothing if the event is being reset to its original visibility (presumably by a visibility event being redacted).
Fires MatrixEventEvent.VisibilityChange if visibilityEvent
caused a change in the actual visibility of this event, either by making it
visible (if it was hidden), by making it hidden (if it was visible) or by
changing the reason (if it was hidden).
Return the visibility change caused by this event, as per https://github.com/matrix-org/matrix-doc/pull/3531.
If the event is a well-formed visibility change event,
an instance of IVisibilityChange, otherwise null.
InternalStart the process of trying to decrypt this event.
(This is used within the SDK: it isn't intended for use by applications)
crypto module
promise which resolves (to undefined) when the decryption attempt is completed.
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
Arguments to pass to the listener
true if the event had listeners, false otherwise.
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
Arguments to pass to the listener
true if the event had listeners, false otherwise.
Similar to emit but calls all listeners within a Promise.all and returns the promise chain
The name of the event to emit
Arguments to pass to the listener
true if the event had listeners, false otherwise.
Similar to emit but calls all listeners within a Promise.all and returns the promise chain
The name of the event to emit
Arguments to pass to the listener
true if the event had listeners, false otherwise.
Flags an event as cancelled due to future conditions. For example, a verification request event in the same sync transaction may be flagged as cancelled to warn listeners that a cancellation event is coming down the same pipe shortly.
Whether the event is to be cancelled or not.
Get the age of this event. This represents the age of the event when the event arrived at the device, and not the age of the event when this function was called. Can only be returned once the server has echo'ed back
The age of this event in milliseconds.
For relations and redactions, returns the event_id this event is referring to.
Returns the status of any associated edit or redaction (not for reactions/annotations as their local echo doesn't affect the original event), or else the status of the event.
Get the ed25519 the sender of this event claims to own.
For Olm messages, this claim is encoded directly in the plaintext of the event itself. For megolm messages, it is implied by the m.room_key event which established the megolm session.
Until we download the device list of the sender, it's just a claim: the device list gives a proof that the owner of the curve25519 key used for this event (and returned by #getSenderKey) also owns the ed25519 key by signing the public curve25519 key with the ed25519 key.
In general, applications should not use this method directly, but should instead use crypto-api!CryptoApi#getEncryptionInfoForEvent.
Gets the cleartext content for this event. If the event is not encrypted, or encryption has not been completed, this will return null.
The cleartext (decrypted) content for the event
Get the timestamp of this event, as a Date object.
The event date, e.g. new Date(1433502692297)
Get either 'content' or 'prev_content' depending on if this event is 'forward-looking' or not. This can be modified via event.forwardLooking. In practice, this means we get the chronologically earlier content value for this event (this method should surely be called getEarlierContent) This method is experimental and may change.
event.content if this event is forward-looking, else event.prev_content.
Gets the event as it would appear if it had been sent unencrypted.
If the event is encrypted, we attempt to mock up an event as it would have looked had the sender not encrypted it. If the event is not encrypted, a copy of it is simply returned as-is.
A shallow copy of the event, in wire format, as it would have been had it not been encrypted.
Get the curve25519 keys of the devices which were involved in telling us about the claimedEd25519Key and sender curve25519 key.
Normally this will be empty, but in the case of a forwarded megolm session, the sender keys are sent to us by another device (the forwarding device), which we need to trust to do this. In that case, the result will be a list consisting of one entry.
If the device that sent us the key (A) got it from another device which it wasn't prepared to vouch for (B), the result will be [A, B]. And so on.
base64-encoded curve25519 keys, from oldest to newest.
Get the event_id for this event.
The event ID, e.g. $143350589368169JsLZx:localhost
Calculate the recipients for keyshare requests.
the user who received this event.
array of recipients
Get the age of the event when this function was called. This is the 'age' field adjusted according to how long this client has had the event.
The age of this event in milliseconds.
Get the user's room membership at the time the event was sent, as reported by the server. This uses MSC4115.
The user's room membership, or undefined if the server does
not report it.
Get the previous event content JSON. This will only return something for state events which exist in the timeline.
The previous event content JSON, or an empty object.
Get the (decrypted, if necessary) redaction event JSON if event was redacted
The redaction event JSON, or an empty object
Get relation info for the event, if any.
Get the room_id for this event. This will return undefined
for m.presence events.
The room ID, e.g. !cURbafjkfsMDVwdRDQ:matrix.org
Get the user_id for this event.
The user ID, e.g. @alice:matrix.org
The curve25519 key for the device that we think sent this event
For an Olm-encrypted event, this is inferred directly from the DH exchange at the start of the session: the curve25519 key is involved in the DH exchange, so only a device which holds the private part of that key can establish such a session.
For a megolm-encrypted event, it is inferred from the Olm message which established the megolm session
Get the event state_key if it has one. This will return undefined
for message events.
The event's state_key.
Get the instance of the thread associated with the current event
Get the timestamp of this event.
The event timestamp, e.g. 1433502692297
Get the (decrypted, if necessary) type of event.
The event type, e.g. m.room.message
Get the (possibly encrypted) event content JSON that will be sent to the homeserver.
The event content JSON, or an empty object.
Get the (possibly encrypted) type of the event that will be sent to the homeserver.
The event type.
Replace the event property and recalculate any properties based on it.
the object to assign to the event property
Checks if this event is associated with another event. See getAssociatedId.
Check if this event is currently being decrypted.
True if this event is currently being decrypted, else false.
Gets whether or not the event is flagged as cancelled. See flagCancelled() for more information.
True if the event is cancelled, false otherwise.
Check if this event is an encrypted event which we failed to decrypt
(This implies that we might retry decryption at some point in the future)
True if this event is an encrypted event which we couldn't decrypt.
Check if the event is encrypted.
True if this event is encrypted.
Determines if this event is equivalent to the given event. This only checks the event object itself, not the other properties of the event. Intended for use with toSnapshot() to identify events changing.
OptionalotherEvent: MatrixEventThe other event to check against.
True if the events are the same, false otherwise.
Whether the decryption key was obtained from an untrusted source. If so, we cannot verify the authenticity of the message.
Check if this event has been redacted
True if this event has been redacted
Check if this event is a redaction of another event
True if this event is a redaction
Get whether the event is a relation event, and of a given type if
relType is passed in. State events cannot be relation events
OptionalrelType: stringif given, checks that the relation is of the given type
Whether the event is in any phase of sending, send failure, waiting for remote echo, etc.
Check if this event is a state event.
True if this is a state event.
Check if this event alters the visibility of another event, as per https://github.com/matrix-org/matrix-doc/pull/3531.
True if this event alters the visibility of another event.
Returns the number of listeners listening to the event named event.
The name of the event being listened for
Returns the event that wants to redact this event, but hasn't been sent yet.
the event
InternalReplace the content of this event with encrypted versions. (This is used when sending an event; it should not be used by applications).
type of the encrypted event - typically "m.room.encrypted"
raw 'content' for the encrypted event.
curve25519 key to record for the sender of this event. See MatrixEvent#getSenderKey.
claimed ed25519 key to record for the sender if this event. See MatrixEvent#getClaimedEd25519Key
Update the content of an event in the same way it would be by the server if it were redacted before it was sent to us
event causing the redaction
the room in which the event exists
Set an event that replaces the content of this event, through an m.replace relation.
OptionalnewEvent: MatrixEventthe event with the replacing content, if any.
Return instructions to display or hide the message.
Instructions determining whether the message should be displayed.
Alias for 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 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.
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 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).
Optionalevent: EventEmitterEvents | MatrixEventEmittedEventsThe name of the event. If undefined, all listeners everywhere are removed.
a reference to the EventEmitter, so that calls can be chained.
Removes the specified listener from the listener array for the event named event.
a reference to the EventEmitter, so that calls can be chained.
Returns the event replacing the content of this event, if any. Replacements are aggregated on the server, so this would only return an event in case it came down the sync, or for local echo of edits.
Returns the origin_server_ts of the event replacing the content of this event, if any.
Returns the event ID of the event replacing the content of this event, if any.
InternalUpdate the sentinels and forwardLooking flag for this event.
the room state to be queried
if true the event's forwardLooking flag is set false
Set the push details for this event.
OptionalpushActions: IActionsObjectpush actions
Optionalrule: IAnnotatedPushRulethe executed push rule
Update the event's sending status and emit an event as well.
The new status
Set the instance of a thread associated with the current event
Optionalthread: Threadthe thread
OptionalthreadId: stringSummarise the event as JSON.
If encrypted, include both the decrypted and encrypted view of the event.
This is named toJSON for use with JSON.stringify which checks objects
for functions named toJSON and will call them to customise the output
if they are defined.
WARNING Do not log the result of this method; otherwise, it will end up in rageshakes, leading to a privacy violation.
Prefer to use MatrixEvent#getEffectiveEvent or similar. This method will be removed soon; it is too easy to use it accidentally and cause a privacy violation (cf https://github.com/vector-im/element-web/issues/26380). In any case, the value it returns is not a faithful serialization of the object.
Get a copy/snapshot of this event. The returned copy will be loosely linked back to this instance, though will have "frozen" event information. Other properties of this MatrixEvent instance will be copied verbatim, which can mean they are in reference to this instance despite being on the copy too. The reference the snapshot uses does not change, however members aside from the underlying event will not be deeply cloned, thus may be mutated internally. For example, the sender profile will be copied over at snapshot time, and the sender profile internally may mutate without notice to the consumer.
This is meant to be used to snapshot the event details themselves, not the features (such as sender) surrounding the event.
A snapshot of this event.
Update the related id with a new one.
Used to replace a local id with remote one before sending an event with a related id.
the new event id
Typed Event Emitter class which can act as a Base Model for all our model and communication events. This makes it much easier for us to distinguish between events, as we now need to properly type this, so that our events are not stringly-based and prone to silly typos.
Type parameters:
Events- List of all events emitted by thisTypedEventEmitter. Normally an enum type.Arguments- A ListenerMap type providing mappings from event names to listener types.SuperclassArguments- TODO: not really sure. Alternative listener mappings, I think? But only honoured for.emit?