mirror of
https://github.com/google/blockly.git
synced 2026-01-09 10:00:09 +01:00
d8fbe1b05b
* Add annotations to files under core/events * Add annotations to files under core/interfaces * Add annotations to files under core/keyboard_nav * Add annotations to files under core/renderers * Add annotations to files under core/serialization * Add annotations to files under core/theme * Add annotations to files under core/toolbox * Add annotations to files under core/utils * Add annotations to files under core
93 lines
2.6 KiB
JavaScript
93 lines
2.6 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2019 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview Utility methods for objects.
|
|
* @author samelh@google.com (Sam El-Husseini)
|
|
*/
|
|
'use strict';
|
|
|
|
/**
|
|
* Utility methods for objects.
|
|
* @namespace Blockly.utils.object
|
|
*/
|
|
goog.module('Blockly.utils.object');
|
|
|
|
|
|
/**
|
|
* Inherit the prototype methods from one constructor into another.
|
|
* @param {!Function} childCtor Child class.
|
|
* @param {!Function} parentCtor Parent class.
|
|
* @suppress {strictMissingProperties} superClass_ is not defined on Function.
|
|
* @alias Blockly.utils.object.inherits
|
|
*/
|
|
const inherits = function(childCtor, parentCtor) {
|
|
// Set a .superClass_ property so that methods can call parent methods
|
|
// without hard-coding the parent class name.
|
|
// Could be replaced by ES6's super().
|
|
childCtor.superClass_ = parentCtor.prototype;
|
|
|
|
// Link the child class to the parent class so that static methods inherit.
|
|
Object.setPrototypeOf(childCtor, parentCtor);
|
|
|
|
// Replace the child constructor's prototype object with an instance
|
|
// of the parent class.
|
|
childCtor.prototype = Object.create(parentCtor.prototype);
|
|
childCtor.prototype.constructor = childCtor;
|
|
// Alternatively, one could use this instead:
|
|
// Object.setPrototypeOf(childCtor.prototype, parentCtor.prototype);
|
|
};
|
|
exports.inherits = inherits;
|
|
|
|
/**
|
|
* Copies all the members of a source object to a target object.
|
|
* @param {!Object} target Target.
|
|
* @param {!Object} source Source.
|
|
* @alias Blockly.utils.object.mixin
|
|
*/
|
|
const mixin = function(target, source) {
|
|
for (const x in source) {
|
|
target[x] = source[x];
|
|
}
|
|
};
|
|
exports.mixin = mixin;
|
|
|
|
/**
|
|
* Complete a deep merge of all members of a source object with a target object.
|
|
* @param {!Object} target Target.
|
|
* @param {!Object} source Source.
|
|
* @return {!Object} The resulting object.
|
|
* @alias Blockly.utils.object.deepMerge
|
|
*/
|
|
const deepMerge = function(target, source) {
|
|
for (const x in source) {
|
|
if (source[x] != null && typeof source[x] === 'object') {
|
|
target[x] = deepMerge(target[x] || Object.create(null), source[x]);
|
|
} else {
|
|
target[x] = source[x];
|
|
}
|
|
}
|
|
return target;
|
|
};
|
|
exports.deepMerge = deepMerge;
|
|
|
|
/**
|
|
* Returns an array of a given object's own enumerable property values.
|
|
* @param {!Object} obj Object containing values.
|
|
* @return {!Array} Array of values.
|
|
* @alias Blockly.utils.object.values
|
|
*/
|
|
const values = function(obj) {
|
|
if (Object.values) {
|
|
return Object.values(obj);
|
|
}
|
|
// Fallback for IE.
|
|
return Object.keys(obj).map(function(e) {
|
|
return obj[e];
|
|
});
|
|
};
|
|
exports.values = values;
|