merge¶
Overview¶
Like Lodash's _.merge, this will recursively merge nested options objects provided that the keys end in 'Options' (case-sensitive) and they are pure object literals. That is, they must be defined by ... = { ... }
or somePropOptions: { ... }
. Non object literals (arrays, functions, and inherited types) or anything with an extra prototype will all throw assertion errors if passed in as an arg or as a value to a *Options
field.
@author Michael Barlow (PhET Interactive Simulations) @author Michael Kauzmann (PhET Interactive Simulations)