/* Copyright 2023 The Matrix.org Foundation C.I.C. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ /* See readme.md for tips on writing these tests. */ /// import { HomeserverInstance } from "../../plugins/utils/homeserver"; import { assertRead, assertReadThread, assertStillRead, assertUnread, backToThreadsList, goTo, markAsRead, Message, MessageContentSpec, MessageFinder, openThread, ReadReceiptSetup, saveAndReload, sendMessageAsClient, } from "./read-receipts-utils"; describe("Read receipts", () => { const roomAlpha = "Room Alpha"; const roomBeta = "Room Beta"; let homeserver: HomeserverInstance; let messageFinder: MessageFinder; let testSetup: ReadReceiptSetup; function editOf(originalMessage: string, newMessage: string): MessageContentSpec { return messageFinder.editOf(originalMessage, newMessage); } function replyTo(targetMessage: string, newMessage: string): MessageContentSpec { return messageFinder.replyTo(targetMessage, newMessage); } function threadedOff(rootMessage: string, newMessage: string): MessageContentSpec { return messageFinder.threadedOff(rootMessage, newMessage); } before(() => { // Note: unusually for the Cypress tests in this repo, we share a single // Synapse between all the tests in this file. // // Stopping and starting Synapse costs about 0.25 seconds per test, so // for most suites this is worth the cost for the extra assurance that // each test is independent. // // Because there are so many tests in this file, and because sharing a // Synapse should have no effect (because we create new rooms and users // for each test), we share it here, saving ~30 seconds per run at time // of writing. cy.startHomeserver("default").then((data) => { homeserver = data; }); }); beforeEach(() => { messageFinder = new MessageFinder(); testSetup = new ReadReceiptSetup(homeserver, "Mae", "Other User", roomAlpha, roomBeta); }); after(() => { cy.stopHomeserver(homeserver); }); /** * Sends messages into given room as a bot * @param room - the name of the room to send messages into * @param messages - the list of messages to send, these can be strings or implementations of MessageSpec like `editOf` */ function receiveMessages(room: string, messages: Message[]) { sendMessageAsClient(testSetup.bot, room, messages); } const room1 = roomAlpha; const room2 = roomBeta; describe("editing messages", () => { describe("in the main timeline", () => { it("Editing a message leaves a room read", () => { // Given I am not looking at the room goTo(room1); receiveMessages(room2, ["Msg1"]); assertUnread(room2, 1); goTo(room2); assertRead(room2); goTo(room1); // When an edit appears in the room receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); // Then it remains read assertStillRead(room2); }); it("Reading an edit leaves the room read", () => { // Given an edit is making the room unread goTo(room1); receiveMessages(room2, ["Msg1"]); assertUnread(room2, 1); goTo(room2); assertRead(room2); goTo(room1); receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); assertStillRead(room2); // When I read it goTo(room2); // Then the room stays read assertStillRead(room2); goTo(room1); assertStillRead(room2); }); it("Editing a message after marking as read leaves the room read", () => { // Given the room is marked as read goTo(room1); receiveMessages(room2, ["Msg1"]); assertUnread(room2, 1); markAsRead(room2); assertRead(room2); // When a message is edited receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); // Then the room remains read assertStillRead(room2); }); it("Editing a reply after reading it makes the room unread", () => { // Given the room is all read goTo(room1); receiveMessages(room2, ["Msg1", replyTo("Msg1", "Reply1")]); assertUnread(room2, 2); goTo(room2); assertRead(room2); goTo(room1); // When a message is edited receiveMessages(room2, [editOf("Reply1", "Reply1 Edit1")]); // Then it remains read assertStillRead(room2); }); it("Editing a reply after marking as read makes the room unread", () => { // Given a reply is marked as read goTo(room1); receiveMessages(room2, ["Msg1", replyTo("Msg1", "Reply1")]); assertUnread(room2, 2); markAsRead(room2); assertRead(room2); // When the reply is edited receiveMessages(room2, [editOf("Reply1", "Reply1 Edit1")]); // Then the room remains read assertStillRead(room2); }); // XXX: fails because flaky: https://github.com/vector-im/element-web/issues/26341 it.skip("A room with an edit is still read after restart", () => { // Given a message is marked as read goTo(room2); receiveMessages(room2, ["Msg1"]); assertRead(room2); goTo(room1); // When an edit appears in the room receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); // Then it remains read assertStillRead(room2); // And remains so after a reload saveAndReload(); assertStillRead(room2); }); it("An edited message becomes read if it happens while I am looking", () => { // Given a message is marked as read goTo(room2); receiveMessages(room2, ["Msg1"]); assertRead(room2); // When I see an edit appear in the room I am looking at receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); // Then it becomes read assertStillRead(room2); }); it("A room where all edits are read is still read after restart", () => { // Given a message was edited and read goTo(room1); receiveMessages(room2, ["Msg1", editOf("Msg1", "Msg1 Edit1")]); assertUnread(room2, 1); goTo(room2); assertRead(room2); // When I reload saveAndReload(); // Then the room is still read assertRead(room2); }); }); describe("in threads", () => { it("An edit of a threaded message makes the room unread", () => { // Given we have read the thread goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); assertUnread(room2, 2); goTo(room2); openThread("Msg1"); assertRead(room2); backToThreadsList(); goTo(room1); // When a message inside it is edited receiveMessages(room2, [editOf("Resp1", "Edit1")]); // Then the room and thread are read assertStillRead(room2); goTo(room2); assertReadThread("Msg1"); }); it("Reading an edit of a threaded message makes the room read", () => { // Given an edited thread message appears after we read it goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); assertUnread(room2, 2); goTo(room2); openThread("Msg1"); assertRead(room2); backToThreadsList(); goTo(room1); receiveMessages(room2, [editOf("Resp1", "Edit1")]); assertStillRead(room2); // When I read it goTo(room2); openThread("Msg1"); // Then the room and thread are still read assertStillRead(room2); assertReadThread("Msg1"); }); it("Marking a room as read after an edit in a thread makes it read", () => { // Given an edit in a thread is making the room unread goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1"), editOf("Resp1", "Edit1")]); assertUnread(room2, 2); // When I mark the room as read markAsRead(room2); // Then it is read assertRead(room2); }); // XXX: flaky it.skip("Editing a thread message after marking as read leaves the room read", () => { // Given a room is marked as read goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); assertUnread(room2, 2); markAsRead(room2); assertRead(room2); // When a message is edited receiveMessages(room2, [editOf("Resp1", "Edit1")]); // Then the room becomes unread assertStillRead(room2); }); // XXX: flaky it.skip("A room with an edited threaded message is still read after restart", () => { // Given an edit in a thread is leaving a room read goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); markAsRead(room2); receiveMessages(room2, [editOf("Resp1", "Edit1")]); assertStillRead(room2); // When I restart saveAndReload(); // Then is it still read assertRead(room2); }); it("A room where all threaded edits are read is still read after restart", () => { goTo(room2); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1"), editOf("Resp1", "Edit1")]); assertUnread(room2, 1); openThread("Msg1"); assertRead(room2); goTo(room1); // Make sure we are looking at room1 after reload assertStillRead(room2); saveAndReload(); assertRead(room2); }); // XXX: fails because the room becomes unread after restart it.skip("A room where all threaded edits are marked as read is still read after restart", () => { goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1"), editOf("Resp1", "Edit1")]); assertUnread(room2, 2); markAsRead(room2); assertRead(room2); // When I restart saveAndReload(); // It is still read assertRead(room2); }); }); describe("thread roots", () => { // XXX: flaky it.skip("An edit of a thread root leaves the room read", () => { // Given I have read a thread goTo(room1); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); assertUnread(room2, 2); goTo(room2); openThread("Msg1"); backToThreadsList(); assertRead(room2); goTo(room1); // When the thread root is edited receiveMessages(room2, [editOf("Msg1", "Edit1")]); // Then the room is read assertStillRead(room2); // And the thread is read goTo(room2); assertStillRead(room2); assertReadThread("Edit1"); }); it("Reading an edit of a thread root leaves the room read", () => { // Given a fully-read thread exists goTo(room2); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); openThread("Msg1"); assertRead(room2); goTo(room1); assertRead(room2); // When the thread root is edited receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); // And I read that edit goTo(room2); // Then the room becomes read and stays read assertStillRead(room2); goTo(room1); assertStillRead(room2); }); it("Editing a thread root after reading leaves the room read", () => { // Given a fully-read thread exists goTo(room2); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); openThread("Msg1"); assertRead(room2); goTo(room1); // When the thread root is edited receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1")]); // Then the room stays read assertStillRead(room2); }); it("Marking a room as read after an edit of a thread root keeps it read", () => { // Given a fully-read thread exists goTo(room2); receiveMessages(room2, ["Msg1", threadedOff("Msg1", "Resp1")]); openThread("Msg1"); assertRead(room2); goTo(room1); assertRead(room2); // When the thread root is edited (and I receive another message // to allow Mark as read) receiveMessages(room2, [editOf("Msg1", "Msg1 Edit1"), "Msg2"]); // And when I mark the room as read markAsRead(room2); // Then the room becomes read and stays read assertStillRead(room2); goTo(room1); assertStillRead(room2); }); // XXX: flaky it.skip("Editing a thread root that is a reply after marking as read leaves the room read", () => { // Given a thread based on a reply exists and is read because it is marked as read goTo(room1); receiveMessages(room2, ["Msg", replyTo("Msg", "Reply"), threadedOff("Reply", "InThread")]); assertUnread(room2, 3); markAsRead(room2); assertRead(room2); // When I edit the thread root receiveMessages(room2, [editOf("Reply", "Edited Reply")]); // Then the room is read assertStillRead(room2); // And the thread is read goTo(room2); assertReadThread("Edited Reply"); }); it("Marking a room as read after an edit of a thread root that is a reply leaves it read", () => { // Given a thread based on a reply exists and the reply has been edited goTo(room1); receiveMessages(room2, ["Msg", replyTo("Msg", "Reply"), threadedOff("Reply", "InThread")]); receiveMessages(room2, [editOf("Reply", "Edited Reply")]); assertUnread(room2, 3); // When I mark the room as read markAsRead(room2); // Then the room and thread are read assertStillRead(room2); goTo(room2); assertReadThread("Edited Reply"); }); }); }); });