mirror of
https://github.com/shaka-project/shaka-player.git
synced 2026-06-19 16:47:01 +03:00
Joey Parrish
e8af210dab
- cleans up config merging now that abr.manager has been removed from the config - uses thing.constructor == Object instead of typeof(thing) == 'object', for better detection of anonymous objects - adds a default (empty) server certificate for type-checking - treats empty certs the same as null (no cert provided) Fixes #784 Change-Id: Ie833a1b3bf484d5f12f3ebf6d513ed51740bdc44
108 lines
3.8 KiB
JavaScript
108 lines
3.8 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2016 Google Inc.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
goog.provide('shaka.util.ConfigUtils');
|
|
|
|
goog.require('goog.asserts');
|
|
goog.require('shaka.log');
|
|
|
|
|
|
/**
|
|
* @param {!Object} destination
|
|
* @param {!Object} source
|
|
* @param {!Object} template supplies default values
|
|
* @param {!Object} overrides
|
|
* Supplies override type checking. When the current path matches the key in
|
|
* this object, each sub-value must match the type in this object. If this
|
|
* contains an Object, it is used as the template.
|
|
* @param {string} path to this part of the config
|
|
*/
|
|
shaka.util.ConfigUtils.mergeConfigObjects =
|
|
function(destination, source, template, overrides, path) {
|
|
goog.asserts.assert(destination, 'Destination config must not be null!');
|
|
|
|
/**
|
|
* @type {boolean}
|
|
* If true, don't validate the keys in the next level.
|
|
*/
|
|
var ignoreKeys = path in overrides;
|
|
|
|
for (var k in source) {
|
|
var subPath = path + '.' + k;
|
|
var subTemplate = ignoreKeys ? overrides[path] : template[k];
|
|
|
|
// The order of these checks is important.
|
|
if (!ignoreKeys && !(k in destination)) {
|
|
shaka.log.error('Invalid config, unrecognized key ' + subPath);
|
|
} else if (source[k] === undefined) {
|
|
// An explicit 'undefined' value causes the key to be deleted from the
|
|
// destination config and replaced with a default from the template if
|
|
// possible.
|
|
if (subTemplate === undefined || ignoreKeys) {
|
|
// There is nothing in the template, so delete.
|
|
delete destination[k];
|
|
} else {
|
|
// There is something in the template, so go back to that.
|
|
destination[k] = subTemplate;
|
|
}
|
|
} else if (subTemplate.constructor == Object &&
|
|
source[k] &&
|
|
source[k].constructor == Object) {
|
|
// These are plain Objects with no other constructor.
|
|
|
|
if (!destination[k]) {
|
|
// The only way we should see a null destination is when ignoreKeys is
|
|
// true, so assert that it is.
|
|
goog.asserts.assert(ignoreKeys, 'Null destination without ignoreKeys!');
|
|
// Initialize the destination with the template so that normal merging
|
|
// and type-checking can happen.
|
|
destination[k] = subTemplate;
|
|
}
|
|
|
|
shaka.util.ConfigUtils.mergeConfigObjects(
|
|
destination[k], source[k], subTemplate, overrides, subPath);
|
|
} else if (typeof source[k] != typeof subTemplate ||
|
|
source[k] == null ||
|
|
source[k].constructor != subTemplate.constructor) {
|
|
// The source is the wrong type. This check allows objects to be nulled,
|
|
// but does not allow null for any non-object fields.
|
|
shaka.log.error('Invalid config, wrong type for ' + subPath);
|
|
} else if (typeof destination[k] == 'function' &&
|
|
destination[k].length != source[k].length) {
|
|
shaka.log.warning(
|
|
'Invalid config, wrong number of arguments for ' + subPath);
|
|
destination[k] = source[k];
|
|
} else {
|
|
destination[k] = source[k];
|
|
}
|
|
}
|
|
};
|
|
|
|
|
|
/**
|
|
* Performs a deep clone of the given simple object. This does not copy
|
|
* prototypes, custom properties (e.g. read-only), or multiple references to
|
|
* the same object. This uses JSON to clone.
|
|
*
|
|
* @template T
|
|
* @param {T} arg
|
|
* @return {T}
|
|
*/
|
|
shaka.util.ConfigUtils.cloneObject = function(arg) {
|
|
return JSON.parse(JSON.stringify(arg));
|
|
};
|