Skip to content

Jitsi Meet - Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.

7.1 KB
Raw Blame
import BaseDialog from './BaseDialog';

const EMAIL_FIELD = '#setEmail';
const CTRL_ALT_REACTION_SHORTCUTS_CHECKBOX = '//input[@name="enable-ctrl-alt-reaction-shortcuts"]';
const FOLLOW_ME_CHECKBOX = '//input[@name="follow-me"]';
const HIDE_SELF_VIEW_CHECKBOX = '//input[@name="hide-self-view"]';
const PIP_SWITCH = '#config-option-browserPiP';
const SETTINGS_DIALOG_CONTENT = '.settings-pane';
const START_AUDIO_MUTED_CHECKBOX = '//input[@name="start-audio-muted"]';
const START_VIDEO_MUTED_CHECKBOX = '//input[@name="start-video-muted"]';
const X_PATH_EXPERIMENTAL_TAB = '//div[contains(@class, "settings-dialog")]//*[text()="Experimental"]';
const X_PATH_MODERATOR_TAB = '//div[contains(@class, "settings-dialog")]//*[text()="Moderator"]';
const X_PATH_MORE_TAB = '//div[contains(@class, "settings-dialog")]//*[text()="General"]';
const X_PATH_PROFILE_TAB = '//div[contains(@class, "settings-dialog")]//*[text()="Profile"]';
const X_PATH_SHORTCUTS_TAB = '//div[contains(@class, "settings-dialog")]//*[text()="Shortcuts"]';

/**
 * The settings dialog.
 */
export default class SettingsDialog extends BaseDialog {
    /**
     *  Waits for the settings dialog to be visible.
     */
    waitForDisplay() {
        return this.participant.driver.$(SETTINGS_DIALOG_CONTENT).waitForDisplayed();
    }

    /**
     * Displays a specific tab in the settings dialog.
     * @param xpath
     * @private
     */
    private async openTab(xpath: string) {
        const elem = this.participant.driver.$(xpath);

        await elem.waitForClickable();
        await elem.click();
    }

    /**
     * Selects the Profile tab to be displayed.
     */
    openProfileTab() {
        return this.openTab(X_PATH_PROFILE_TAB);
    }

    /**
     * Selects the More tab to be displayed.
     */
    openMoreTab() {
        return this.openTab(X_PATH_MORE_TAB);
    }

    /**
     * Selects the moderator tab to be displayed.
     */
    openModeratorTab() {
        return this.openTab(X_PATH_MODERATOR_TAB);
    }

    /**
     * Selects the Shortcuts tab to be displayed.
     */
    openShortcutsTab() {
        return this.openTab(X_PATH_SHORTCUTS_TAB);
    }

    /**
     * Returns whether the Experimental tab is offered. It is hidden when no config option can be changed by the user in
     * the current browser and deployment.
     */
    hasExperimentalTab() {
        return this.participant.driver.$(X_PATH_EXPERIMENTAL_TAB).isExisting();
    }

    /**
     * Selects the Experimental tab to be displayed.
     */
    openExperimentalTab() {
        return this.openTab(X_PATH_EXPERIMENTAL_TAB);
    }

    /**
     * Returns whether browser Picture-in-Picture is switched on in the Experimental tab.
     */
    async isPictureInPictureEnabled() {
        await this.openExperimentalTab();

        return this.participant.driver.$(PIP_SWITCH).isSelected();
    }

    /**
     * Switches browser Picture-in-Picture on or off in the Experimental tab.
     *
     * @param enable - Whether Picture-in-Picture should be on.
     */
    async setPictureInPictureEnabled(enable: boolean) {
        await this.openExperimentalTab();

        const pipSwitch = this.participant.driver.$(PIP_SWITCH);

        await pipSwitch.waitForExist();

        if (enable !== await pipSwitch.isSelected()) {
            await pipSwitch.moveTo();
            await pipSwitch.click();
        }
    }

    /**
     * Returns whether the Firefox-only Ctrl+Alt reaction shortcut setting exists.
     */
    hasCtrlAltReactionShortcutsSetting() {
        return this.participant.driver.$(CTRL_ALT_REACTION_SHORTCUTS_CHECKBOX).isExisting();
    }

    /**
     * Returns whether Ctrl+Alt reaction shortcut aliases are enabled.
     */
    isCtrlAltReactionShortcutsEnabled() {
        return this.participant.driver.$(CTRL_ALT_REACTION_SHORTCUTS_CHECKBOX).isSelected();
    }

    /**
     * Enables or disables Ctrl+Alt reaction shortcut aliases.
     *
     * @param enable - Whether the aliases should be enabled.
     */
    setCtrlAltReactionShortcutsEnabled(enable: boolean) {
        return this.setCheckbox(CTRL_ALT_REACTION_SHORTCUTS_CHECKBOX, enable);
    }

    /**
     * Returns the shortcut key labels currently displayed on the Shortcuts tab.
     */
    async getShortcutKeyLabels() {
        const elements = await this.participant.driver.$$('//ul/li/span[last()]/span');

        return elements.map(element => element.getText());
    }

    /**
     * Enters the passed in email into the email field.
     * @param email
     */
    async setEmail(email: string) {
        await this.openProfileTab();

        await this.participant.driver.$(EMAIL_FIELD).setValue(email);
    }

    /**
     * Returns the participant's email displayed in the settings dialog.
     */
    async getEmail() {
        await this.openProfileTab();

        return await this.participant.driver.$(EMAIL_FIELD).getValue();
    }

    /**
     * Clicks the OK button on the settings dialog to close the dialog and save any changes made.
     */
    submit() {
        return this.clickOkButton();
    }

    /**
     * Sets the start audio muted feature to enabled/disabled.
     * @param {boolean} enable - true for enabled and false for disabled.
     * @returns {Promise<void>}
     */
    async setStartAudioMuted(enable: boolean) {
        await this.openModeratorTab();

        await this.setCheckbox(START_AUDIO_MUTED_CHECKBOX, enable);
    }

    /**
     * Sets the start video muted feature to enabled/disabled.
     * @param {boolean} enable - true for enabled and false for disabled.
     * @returns {Promise<void>}
     */
    async setStartVideoMuted(enable: boolean) {
        await this.openModeratorTab();

        await this.setCheckbox(START_VIDEO_MUTED_CHECKBOX, enable);
    }

    /**
     * Sets the state checked/selected of a checkbox in the settings dialog.
     */
    async setHideSelfView(hideSelfView: boolean) {
        await this.openMoreTab();

        await this.setCheckbox(HIDE_SELF_VIEW_CHECKBOX, hideSelfView);
    }

    /**
     * Sets the follow me feature to enabled/disabled.
     * @param enable
     */
    async setFollowMe(enable: boolean) {
        await this.openModeratorTab();

        await this.setCheckbox(FOLLOW_ME_CHECKBOX, enable);
    }

    /**
     * Returns true if the follow me checkbox is displayed in the settings dialog.
     */
    async isFollowMeDisplayed() {
        const elem = this.participant.driver.$(X_PATH_MODERATOR_TAB);

        if (!await elem.isExisting()) {
            return false;
        }

        await this.openModeratorTab();

        return await this.participant.driver.$$(FOLLOW_ME_CHECKBOX).length > 0;
    }

    /**
     * Sets the state of a checkbox.
     * @param selector
     * @param enable
     * @private
     */
    private async setCheckbox(selector: string, enable: boolean) {
        const checkbox = this.participant.driver.$(selector);

        await checkbox.waitForExist();

        if (enable !== await checkbox.isSelected()) {
            // we show a div with svg and text after the input and those elements grab the click
            // so we need to click on the parent element
            await this.participant.driver.$(`${selector}//ancestor::div[1]`).click();
        }
    }
}