jiti-meet/react/features/base/settings/functions.any.ts

136 lines
4.0 KiB
TypeScript
Raw Normal View History

import { IReduxState } from '../../app/types';
import { IStateful } from '../app/types';
import CONFIG_WHITELIST from '../config/configWhitelist';
import { IConfigState } from '../config/reducer';
import { IJwtState } from '../jwt/reducer';
import { getParticipantCount } from '../participants/functions';
import { toState } from '../redux/functions';
import { parseURLParams } from '../util/parseURLParams';
import { DEFAULT_SERVER_URL } from './constants';
import { ISettingsState } from './reducer';
/**
* Returns the effective value of a configuration/preference/setting by applying
* a precedence among the values specified by JWT, URL, settings,
* and config.
*
2021-11-04 21:10:43 +00:00
* @param {Object|Function} stateful - The redux state object or {@code getState} function.
* @param {string} propertyName - The name of the
* configuration/preference/setting (property) to retrieve.
2021-11-04 21:10:43 +00:00
* @param {Object} sources - Flags indicating the configuration/preference/setting sources to
* consider/retrieve values from.
* @param {boolean} sources.config - Config.
* @param {boolean} jwt - JWT.
* @param {boolean} settings - Settings.
* @param {boolean} urlParams - URL parameters.
* @returns {any}
*/
export function getPropertyValue(
stateful: IStateful,
propertyName: string,
sources?: any
) {
// Default values don't play nicely with partial objects and we want to make
// the function easy to use without exhaustively defining all flags:
sources = { // eslint-disable-line no-param-reassign
// Defaults:
config: true,
jwt: true,
settings: true,
urlParams: true,
...sources
};
// Precedence: jwt -> urlParams -> settings -> config.
const state = toState(stateful);
// jwt
if (sources.jwt) {
const value = state['features/base/jwt'][propertyName as keyof IJwtState];
if (typeof value !== 'undefined') {
return value[propertyName as keyof typeof value];
}
}
// urlParams
if (sources.urlParams) {
2019-11-01 13:24:52 +00:00
if (CONFIG_WHITELIST.indexOf(propertyName) !== -1) {
const urlParams
= parseURLParams(state['features/base/connection'].locationURL ?? '');
2019-11-01 13:24:52 +00:00
const value = urlParams[`config.${propertyName}`];
2019-11-01 13:24:52 +00:00
if (typeof value !== 'undefined') {
return value;
}
}
}
// settings
if (sources.settings) {
const value = state['features/base/settings'][propertyName as keyof ISettingsState];
if (typeof value !== 'undefined') {
return value;
}
}
// config
if (sources.config) {
const value = state['features/base/config'][propertyName as keyof IConfigState];
if (typeof value !== 'undefined') {
return value;
}
}
return undefined;
}
/**
* Gets the currently configured server URL.
*
* @param {Object|Function} stateful - The redux state object or
* {@code getState} function.
* @returns {string} - The currently configured server URL.
*/
export function getServerURL(stateful: IStateful) {
const state = toState(stateful);
return state['features/base/settings'].serverURL || DEFAULT_SERVER_URL;
}
/**
* Should we hide the helper dialog when a user tries to do audio only screen sharing.
*
* @param {Object} state - The state of the application.
* @returns {boolean}
*/
export function shouldHideShareAudioHelper(state: IReduxState): boolean | undefined {
return state['features/base/settings'].hideShareAudioHelper;
}
/**
* Whether we should hide self view.
*
* @param {Object} state - Redux state.
* @returns {boolean}
*/
export function shouldHideSelfView(state: IReduxState) {
return getParticipantCount(state) === 1 ? false : getHideSelfView(state);
}
/**
* Gets the disable self view setting.
*
* @param {Object} state - Redux state.
* @returns {boolean}
*/
export function getHideSelfView(state: IReduxState) {
return state['features/base/config'].disableSelfView || state['features/base/settings'].disableSelfView;
}