RTCUtil.js

'use strict';

/**
 * Internal util for deep clone object. Object.assign() only does a shallow copy
 *
 * @param {Object} obj - object to be cloned
 * @return {Object} cloned obj
 */
function _deepClone(obj) {
  return JSON.parse(JSON.stringify(obj));
}

/**
 * Merge custom constraints with the default one. The custom one take precedence.
 *
 * @param {Object} custom - custom webrtc constraints
 * @param {Object} def - default webrtc constraints
 * @return {Object} constraints - merged webrtc constraints
 */
export function mergeMediaConstraints(custom, def) {
  const constraints = (def ? _deepClone(def) : {});
  if (custom) {
    if (custom.mandatory) {
      constraints.mandatory = {...constraints.mandatory, ...custom.mandatory};
    }
    if (custom.optional && Array.isArray(custom.optional)) {
      // `optional` is an array, webrtc only finds first and ignore the rest if duplicate.
      constraints.optional = custom.optional.concat(constraints.optional);
    }
    if (custom.facingMode) {
      constraints.facingMode = custom.facingMode.toString(); // string, 'user' or the default 'environment'
    }
  }
  return constraints;
}