Add tests for presentation permission tab (moderatorOnly, requireApproval, freeForAll)

Co-authored-by: germanocaumo <2726293+germanocaumo@users.noreply.github.com>

Author: Copilot

bigbluebutton-tests/playwright/core/elements.ts

@@ -472,6 +472,15 @@ export const elements = {
   guestPolicySelector: '[data-test="guestPolicySelector"]',
   participantPermissionsTab: '[data-test="participantPermissionsTab"]',
   presentationPermissionsTab: '[data-test="presentationPermissionsTab"]',
+  presentationPolicySelector: '[data-test="presentationPolicySelector"]',
+  presModeratorOnly: 'li[data-test="presModeratorOnly"]',
+  presRequireApproval: 'li[data-test="presRequireApproval"]',
+  presFreeForAll: 'li[data-test="presFreeForAll"]',
+  takePresenterButton: 'button[data-test="takePresenterButton"]',
+  requestPresenterButton: 'button[data-test="requestPresenterButton"]',
+  waitingPresenterButton: 'button[data-test="waitingPresenterButton"]',
+  approvePresenter: 'button[data-test="approvePresenter"]',
+  denyPresenter: 'button[data-test="denyPresenter"]',
   lockShareWebcam: 'input[data-test="lockShareWebcam"]',
   lockSeeOtherViewersWebcam: 'input[data-test="lockSeeOtherViewersWebcam"]',
   lockShareMicrophone: 'input[data-test="lockShareMicrophone"]',

bigbluebutton-tests/playwright/user/lockViewers.ts

@@ -5,7 +5,7 @@ import { ELEMENT_WAIT_LONGER_TIME, ELEMENT_WAIT_TIME } from '../core/constants';
 import { elements as e } from '../core/elements';
 import { getNotesLocator } from '../sharednotes/util';
 import { MultiUsers } from './multiusers';
-import { drawArrow, openLockViewers } from './util';
+import { drawArrow, openLockViewers, setPresentationPermission } from './util';
 
 export class LockViewers extends MultiUsers {
   async lockShareWebcam() {
@@ -423,4 +423,71 @@ export class LockViewers extends MultiUsers {
       'should be displayed the other viewer whiteboard cursor indicator when unlocking user is unlocked',
     );
   }
+
+  async presenterPolicyModeratorOnly() {
+    // Lock the viewer (disableCam) so the moderatorOnly restriction applies, and set moderatorOnly policy
+    await openLockViewers(this.modPage);
+    await this.modPage.waitAndClick(e.participantPermissionsTab);
+    await this.modPage.waitAndClickElement(e.lockShareWebcam);
+    await this.modPage.waitAndClick(e.presentationPermissionsTab);
+    await this.modPage.waitAndClick(e.presentationPolicySelector);
+    await this.modPage.waitAndClick(e.presModeratorOnly);
+    await this.modPage.waitAndClick(e.applyLockSettings);
+    // Locked viewer should see no action button in the media area
+    await this.userPage.waitAndClick(e.mediaAreaButton);
+    await this.userPage.wasRemoved(
+      e.takePresenterButton,
+      'should not display a take presenter button for a locked viewer under moderatorOnly policy',
+    );
+    await this.userPage.wasRemoved(
+      e.requestPresenterButton,
+      'should not display a request presenter button for a locked viewer under moderatorOnly policy',
+    );
+  }
+
+  async presenterPolicyRequireApproval() {
+    await setPresentationPermission(this.modPage, e.presRequireApproval);
+    // Viewer opens media area and sees the request presenter button
+    await this.userPage.waitAndClick(e.mediaAreaButton);
+    await this.userPage.hasElement(
+      e.requestPresenterButton,
+      'should display the request presenter button for the viewer under requireApproval policy',
+    );
+    // Viewer requests presenter role
+    await this.userPage.waitAndClick(e.requestPresenterButton);
+    await this.userPage.hasElement(
+      e.waitingPresenterButton,
+      'should display the waiting presenter button while the request is pending',
+    );
+    // Moderator approves the request
+    await this.modPage.hasElement(
+      e.approvePresenter,
+      'should display the approve presenter button for the moderator',
+      ELEMENT_WAIT_LONGER_TIME,
+    );
+    await this.modPage.waitAndClick(e.approvePresenter);
+    // Viewer becomes presenter
+    await this.userPage.hasElement(
+      e.wbToolbar,
+      'should display the whiteboard toolbar after viewer becomes presenter',
+      ELEMENT_WAIT_LONGER_TIME,
+    );
+  }
+
+  async presenterPolicyFreeForAll() {
+    await setPresentationPermission(this.modPage, e.presFreeForAll);
+    // Viewer opens media area and sees the take presenter button directly
+    await this.userPage.waitAndClick(e.mediaAreaButton);
+    await this.userPage.hasElement(
+      e.takePresenterButton,
+      'should display the take presenter button for the viewer under freeForAll policy',
+    );
+    // Viewer takes presenter without moderator approval
+    await this.userPage.waitAndClick(e.takePresenterButton);
+    await this.userPage.hasElement(
+      e.wbToolbar,
+      'should display the whiteboard toolbar after viewer takes presenter under freeForAll policy',
+      ELEMENT_WAIT_LONGER_TIME,
+    );
+  }
 }

bigbluebutton-tests/playwright/user/user.spec.ts

@@ -245,6 +245,26 @@ test.describe.parallel('User', { tag: '@ci' }, () => {
         await lockViewers.initPages(page, testInfo);
         await lockViewers.lockSeeOtherViewersCursor();
       });
+
+      test.describe.parallel('Presentation permissions', () => {
+        test('Moderator only', async ({ browser, context, page }, testInfo) => {
+          const lockViewers = new LockViewers(browser, context);
+          await lockViewers.initPages(page, testInfo);
+          await lockViewers.presenterPolicyModeratorOnly();
+        });
+
+        test('Require approval', async ({ browser, context, page }, testInfo) => {
+          const lockViewers = new LockViewers(browser, context);
+          await lockViewers.initPages(page, testInfo);
+          await lockViewers.presenterPolicyRequireApproval();
+        });
+
+        test('Free for all', async ({ browser, context, page }, testInfo) => {
+          const lockViewers = new LockViewers(browser, context);
+          await lockViewers.initPages(page, testInfo);
+          await lockViewers.presenterPolicyFreeForAll();
+        });
+      });
     });
 
     // https://docs.bigbluebutton.org/3.0/testing/release-testing/#saving-usernames

bigbluebutton-tests/playwright/user/util.ts

@@ -1,10 +1,11 @@
 import { Locator } from '@playwright/test';
 
+import { ELEMENT_WAIT_TIME } from '../core/constants';
 import { elements as e } from '../core/elements';
 import { Page } from '../core/page';
 
 export async function openLockViewers(testPage: Page) {
-  const isLockViewersButtonVisible = await testPage.page.locator(e.lockViewersButton).isVisible({ timeout: 1000 }).catch(() => false);
+  const isLockViewersButtonVisible = await testPage.page.locator(e.lockViewersButton).isVisible({ timeout: ELEMENT_WAIT_TIME }).catch(() => false);
   if (!isLockViewersButtonVisible) {
     await testPage.waitAndClick(e.usersListSidebarButton);
   }
@@ -19,6 +20,14 @@ export async function setGuestPolicyOption(testPage: Page, option: string) {
   await testPage.waitAndClick(e.applyLockSettings);
 }
 
+export async function setPresentationPermission(testPage: Page, option: string) {
+  await openLockViewers(testPage);
+  await testPage.waitAndClick(e.presentationPermissionsTab);
+  await testPage.waitAndClick(e.presentationPolicySelector);
+  await testPage.waitAndClick(option);
+  await testPage.waitAndClick(e.applyLockSettings);
+}
+
 export async function checkAvatarIcon(testPage: Page, checkModIcon = true) {
   await testPage.hasElement(
     `${e.currentUser} ${checkModIcon ? e.moderatorAvatar : e.viewerAvatar}`,