/* Copyright 2023 Suguru Hirahara 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. */ import type { Locator, Page } from "@playwright/test"; import { test, expect } from "../../element-web-test"; import { SettingLevel } from "../../../src/settings/SettingLevel"; import { Layout } from "../../../src/settings/enums/Layout"; import { ElementAppPage } from "../../pages/ElementAppPage"; test.describe("Audio player", () => { test.use({ displayName: "Hanako", }); const uploadFile = async (page: Page, file: string) => { // Upload a file from the message composer await page.locator(".mx_MessageComposer_actions input[type='file']").setInputFiles(file); // Find and click primary "Upload" button await page.locator(".mx_Dialog").getByRole("button", { name: "Upload" }).click(); // Wait until the file is sent await expect(page.locator(".mx_RoomView_statusArea_expanded")).not.toBeVisible(); await expect(page.locator(".mx_EventTile.mx_EventTile_last .mx_EventTile_receiptSent")).toBeVisible(); // wait for the tile to finish loading await expect( page .locator(".mx_AudioPlayer_mediaName") .last() .filter({ hasText: file.split("/").at(-1) }), ).toBeVisible(); }; /** * Take snapshots of mx_EventTile_last on each layout, outputting log for reference/debugging. * @param detail The snapshot name. Used for outputting logs too. * @param monospace This changes the font used to render the UI from a default one to Inconsolata. Set to false by default. */ const takeSnapshots = async (page: Page, app: ElementAppPage, detail: string, monospace = false) => { // Check that the audio player is rendered and its button becomes visible const checkPlayerVisibility = async (locator: Locator) => { // Assert that the audio player and media information are visible const mediaInfo = locator.locator( ".mx_EventTile_mediaLine .mx_MAudioBody .mx_AudioPlayer_container .mx_AudioPlayer_mediaInfo", ); await expect(mediaInfo.locator(".mx_AudioPlayer_mediaName", { hasText: ".ogg" })).toBeVisible(); // extension await expect(mediaInfo.locator(".mx_AudioPlayer_byline", { hasText: "00:01" })).toBeVisible(); await expect(mediaInfo.locator(".mx_AudioPlayer_byline", { hasText: "(3.56 KB)" })).toBeVisible(); // actual size // Assert that the play button can be found and is visible await expect(locator.getByRole("button", { name: "Play" })).toBeVisible(); if (monospace) { // Assert that the monospace timer is visible await expect(locator.locator("[role='timer']")).toHaveCSS("font-family", "Inconsolata"); } }; if (monospace) { // Enable system font and monospace setting await app.settings.setValue("useBundledEmojiFont", null, SettingLevel.DEVICE, false); await app.settings.setValue("useSystemFont", null, SettingLevel.DEVICE, true); await app.settings.setValue("systemFont", null, SettingLevel.DEVICE, "Inconsolata"); } // Check the status of the seek bar expect(await page.locator(".mx_AudioPlayer_seek input[type='range']").count()).toBeGreaterThan(0); // Enable IRC layout await app.settings.setValue("layout", null, SettingLevel.DEVICE, Layout.IRC); const ircTile = page.locator(".mx_EventTile_last[data-layout='irc']"); // Click the event timestamp to highlight EventTile in case it is not visible await ircTile.locator(".mx_MessageTimestamp").click(); // Assert that rendering of the player settled and the play button is visible before taking a snapshot await checkPlayerVisibility(ircTile); const screenshotOptions = { css: ` /* The timestamp is of inconsistent width depending on the time the test runs at */ .mx_MessageTimestamp { display: none !important; } `, mask: [page.locator(".mx_AudioPlayer_seek")], }; // Take a snapshot of mx_EventTile_last on IRC layout await expect(page.locator(".mx_EventTile_last")).toMatchScreenshot( `${detail.replaceAll(" ", "-")}-irc-layout.png`, screenshotOptions, ); // Take a snapshot on modern/group layout await app.settings.setValue("layout", null, SettingLevel.DEVICE, Layout.Group); const groupTile = page.locator(".mx_EventTile_last[data-layout='group']"); await groupTile.locator(".mx_MessageTimestamp").click(); await checkPlayerVisibility(groupTile); await expect(page.locator(".mx_EventTile_last")).toMatchScreenshot( `${detail.replaceAll(" ", "-")}-group-layout.png`, screenshotOptions, ); // Take a snapshot on bubble layout await app.settings.setValue("layout", null, SettingLevel.DEVICE, Layout.Bubble); const bubbleTile = page.locator(".mx_EventTile_last[data-layout='bubble']"); await bubbleTile.locator(".mx_MessageTimestamp").click(); await checkPlayerVisibility(bubbleTile); await expect(page.locator(".mx_EventTile_last")).toMatchScreenshot( `${detail.replaceAll(" ", "-")}-bubble-layout.png`, screenshotOptions, ); }; test.beforeEach(async ({ page, app, user }) => { await app.client.createRoom({ name: "Test Room" }); await app.viewRoomByName("Test Room"); // Wait until configuration is finished await expect( page .locator(".mx_GenericEventListSummary[data-layout='group'] .mx_GenericEventListSummary_summary") .getByText(`${user.displayName} created and configured the room.`), ).toBeVisible(); }); test("should be correctly rendered - light theme", async ({ page, app }) => { await uploadFile(page, "cypress/fixtures/1sec-long-name-audio-file.ogg"); await takeSnapshots(page, app, "Selected EventTile of audio player (light theme)"); }); test("should be correctly rendered - light theme with monospace font", async ({ page, app }) => { await uploadFile(page, "cypress/fixtures/1sec-long-name-audio-file.ogg"); await takeSnapshots(page, app, "Selected EventTile of audio player (light theme, monospace font)", true); // Enable monospace }); test("should be correctly rendered - high contrast theme", async ({ page, app }) => { // Disable system theme in case ThemeWatcher enables the theme automatically, // so that the high contrast theme can be enabled await app.settings.setValue("use_system_theme", null, SettingLevel.DEVICE, false); // Enable high contrast manually const settings = await app.settings.openUserSettings("Appearance"); await settings.getByTestId("mx_ThemeChoicePanel").getByText("Use high contrast").click(); await app.closeDialog(); await uploadFile(page, "cypress/fixtures/1sec-long-name-audio-file.ogg"); await takeSnapshots(page, app, "Selected EventTile of audio player (high contrast)"); }); test("should be correctly rendered - dark theme", async ({ page, app }) => { // Enable dark theme await app.settings.setValue("theme", null, SettingLevel.ACCOUNT, "dark"); await uploadFile(page, "cypress/fixtures/1sec-long-name-audio-file.ogg"); await takeSnapshots(page, app, "Selected EventTile of audio player (dark theme)"); }); test("should play an audio file", async ({ page, app }) => { await uploadFile(page, "cypress/fixtures/1sec.ogg"); // Assert that the audio player is rendered const container = page.locator(".mx_EventTile_last .mx_AudioPlayer_container"); // Assert that the counter is zero before clicking the play button await expect(container.locator(".mx_AudioPlayer_seek [role='timer']", { hasText: "00:00" })).toBeVisible(); // Find and click "Play" button, the wait is to make the test less flaky await expect(container.getByRole("button", { name: "Play" })).toBeVisible(); await container.getByRole("button", { name: "Play" }).click(); // Assert that "Pause" button can be found await expect(container.getByRole("button", { name: "Pause" })).toBeVisible(); // Assert that the timer is reset when the audio file finished playing await expect(container.locator(".mx_AudioPlayer_seek [role='timer']", { hasText: "00:00" })).toBeVisible(); // Assert that "Play" button can be found await expect(container.getByRole("button", { name: "Play" })).toBeVisible(); }); test("should support downloading an audio file", async ({ page, app }) => { await uploadFile(page, "cypress/fixtures/1sec.ogg"); const downloadPromise = page.waitForEvent("download"); // Find and click "Download" button on MessageActionBar const tile = page.locator(".mx_EventTile_last"); await tile.hover(); await tile.getByRole("button", { name: "Download" }).click(); // Assert that the file was downloaded const download = await downloadPromise; expect(download.suggestedFilename()).toBe("1sec.ogg"); }); test("should support replying to audio file with another audio file", async ({ page, app }) => { await uploadFile(page, "cypress/fixtures/1sec.ogg"); // Assert the audio player is rendered await expect(page.locator(".mx_EventTile_last .mx_AudioPlayer_container")).toBeVisible(); // Find and click "Reply" button on MessageActionBar const tile = page.locator(".mx_EventTile_last"); await tile.hover(); await tile.getByRole("button", { name: "Reply", exact: true }).click(); // Reply to the player with another audio file await uploadFile(page, "cypress/fixtures/1sec.ogg"); // Assert that the audio player is rendered await expect(tile.locator(".mx_AudioPlayer_container")).toBeVisible(); // Assert that replied audio file is rendered as file button inside ReplyChain const button = tile.locator(".mx_ReplyChain_wrapper .mx_MFileBody_info[role='button']"); // Assert that the file button has file name await expect(button.locator(".mx_MFileBody_info_filename")).toBeVisible(); await takeSnapshots(page, app, "Selected EventTile of audio player with a reply"); }); test("should support creating a reply chain with multiple audio files", async ({ page, app, user }) => { // Note: "mx_ReplyChain" element is used not only for replies which // create a reply chain, but also for a single reply without a replied // message. This test checks whether a reply chain which consists of // multiple audio file replies is rendered properly. const tile = page.locator(".mx_EventTile_last"); // Find and click "Reply" button const clickButtonReply = async () => { await tile.hover(); await tile.getByRole("button", { name: "Reply", exact: true }).click(); }; await uploadFile(page, "cypress/fixtures/upload-first.ogg"); // Assert that the audio player is rendered await expect(page.locator(".mx_EventTile_last .mx_AudioPlayer_container")).toBeVisible(); await clickButtonReply(); // Reply to the player with another audio file await uploadFile(page, "cypress/fixtures/upload-second.ogg"); // Assert that the audio player is rendered await expect(page.locator(".mx_EventTile_last .mx_AudioPlayer_container")).toBeVisible(); await clickButtonReply(); // Reply to the player with yet another audio file to create a reply chain await uploadFile(page, "cypress/fixtures/upload-third.ogg"); // Assert that the audio player is rendered await expect(tile.locator(".mx_AudioPlayer_container")).toBeVisible(); // Assert that there are two "mx_ReplyChain" elements await expect(tile.locator(".mx_ReplyChain")).toHaveCount(2); // Assert that one line contains the user name await expect(tile.locator(".mx_ReplyChain .mx_ReplyTile_sender").getByText(user.displayName)).toBeVisible(); // Assert that the other line contains the file button await expect(tile.locator(".mx_ReplyChain .mx_MFileBody")).toBeVisible(); // Click "In reply to" await tile.locator(".mx_ReplyChain .mx_ReplyChain_show", { hasText: "In reply to" }).click(); const replyChain = tile.locator(".mx_ReplyChain:first-of-type"); // Assert that "In reply to" has disappeared await expect(replyChain.getByText("In reply to")).not.toBeVisible(); // Assert that the file button contains the name of the file sent at first await expect( replyChain .locator(".mx_MFileBody_info[role='button']") .locator(".mx_MFileBody_info_filename", { hasText: "upload-first.ogg" }), ).toBeVisible(); // Take snapshots await takeSnapshots(page, app, "Selected EventTile of audio player with a reply chain"); }); test("should be rendered, play, and support replying on a thread", async ({ page, app }) => { await uploadFile(page, "cypress/fixtures/1sec-long-name-audio-file.ogg"); // On the main timeline const messageList = page.locator(".mx_RoomView_MessageList"); // Assert the audio player is rendered await expect(messageList.locator(".mx_EventTile_last .mx_AudioPlayer_container")).toBeVisible(); // Find and click "Reply in thread" button await messageList.locator(".mx_EventTile_last").hover(); await messageList.locator(".mx_EventTile_last").getByRole("button", { name: "Reply in thread" }).click(); // On a thread const thread = page.locator(".mx_ThreadView"); const threadTile = thread.locator(".mx_EventTile_last"); const audioPlayer = threadTile.locator(".mx_AudioPlayer_container"); // Assert that the counter is zero before clicking the play button await expect(audioPlayer.locator(".mx_AudioPlayer_seek [role='timer']", { hasText: "00:00" })).toBeVisible(); // Find and click "Play" button, the wait is to make the test less flaky await expect(audioPlayer.getByRole("button", { name: "Play" })).toBeVisible(); await audioPlayer.getByRole("button", { name: "Play" }).click(); // Assert that "Pause" button can be found await expect(audioPlayer.getByRole("button", { name: "Pause" })).toBeVisible(); // Assert that the timer is reset when the audio file finished playing await expect(audioPlayer.locator(".mx_AudioPlayer_seek [role='timer']", { hasText: "00:00" })).toBeVisible(); // Assert that "Play" button can be found await expect(audioPlayer.getByRole("button", { name: "Play" })).not.toBeDisabled(); // Find and click "Reply" button await threadTile.hover(); await threadTile.getByRole("button", { name: "Reply", exact: true }).click(); const composer = thread.locator(".mx_MessageComposer--compact"); // Assert that the reply preview contains audio ReplyTile the file info button await expect( composer.locator(".mx_ReplyPreview .mx_ReplyTile_audio .mx_MFileBody_info[role='button']"), ).toBeVisible(); // Select :smile: emoji and send it await composer.getByTestId("basicmessagecomposer").fill(":smile:"); await composer.locator(".mx_Autocomplete_Completion[aria-selected='true']").click(); await composer.getByTestId("basicmessagecomposer").press("Enter"); // Assert that the file name is rendered on the file button await expect(threadTile.locator(".mx_ReplyTile_audio .mx_MFileBody_info[role='button']")).toBeVisible(); }); });