Function apply

Performs the actions given as object property values with the specified target and the corresponding property key. If an action returns a value, the value will be used as target for a recursive call with the same actions.

If an action (property value) is an object instead of a function then Apply is called again with the action as the !st argument (actions) and the property of the target bearing the same key as the 2nd argument (target).

A getter may be supplied (as the get property of the options argument) to obtain properties from the target. This may be necessary when the property to obtain is not a simple property of the target object, or the target is not even an object in the first place. The getter will be called with the target and the property key to return a value which Apply assumes to be the target's property with that key.

Extra arguments to the actions may also be supplied (as the args property of the options argument). This can help to reuse the same functions needed when implementing other functions that use Apply in their operations.

Example

import { apply } from 'deleight/object/apply'
const object = { a: 1, b: 2, c: { d: 4, e: 5 } };
const f1 = (obj, key) => obj[key] *= 2;
const f2 = (obj, key) => obj[key] *= 3;
const f3 = (obj, key) => console.log(key, obj[key]);

apply({ a: f1, c: { d: f3, e: f2 } }, object);
// object === { a: 2, b: 2, c: { d: 4, e: 15 } };
Copy