method
util
Creates a function that invokes the method at path of a given object.
Installation
Import
import { method } from '@tulx/utils';Source Code
Implementation
/**
* Creates a function that invokes the method at path of a given object.
*
* @param path - The path of the method to invoke.
* @param args - The arguments to invoke the method with.
* @returns Returns the new invoker function.
*
* @example
* ```ts
* const objects = [
* { 'a': { 'b': () => 2 } },
* { 'a': { 'b': () => 1 } }
* ];
* map(objects, method('a.b')); // [2, 1]
* ```
*/
export function method(
path: string | readonly (string | number)[],
...args: readonly unknown[]
): (object: Record<string, unknown>) => unknown {
return function (object: Record<string, unknown>): unknown {
const pathArray = Array.isArray(path) ? path : parsePath(String(path));
let current: unknown = object;
for (const key of pathArray) {
if (
current === null ||
current === undefined ||
typeof current !== 'object'
) {
return undefined;
}
current = (current as Record<string, unknown>)[String(key)];
}
if (typeof current === 'function') {
return (current as (...args: unknown[]) => unknown).apply(object, [
...args,
]);
}
return undefined;
};
}
function parsePath(path: string): string[] {
const keys: string[] = [];
let current = '';
let inBrackets = false;
for (let i = 0; i < path.length; i++) {
const char = path[i];
if (char === '[') {
if (current) {
keys.push(current);
current = '';
}
inBrackets = true;
} else if (char === ']') {
if (current) {
keys.push(current);
current = '';
}
inBrackets = false;
} else if (char === '.' && !inBrackets) {
if (current) {
keys.push(current);
current = '';
}
} else {
current += char;
}
}
if (current) {
keys.push(current);
}
return keys;
}
Example
import { method } from '@tulx/utils';
const objects = [
{ 'a': { 'b': () => 2 } },
{ 'a': { 'b': () => 1 } }
];
map(objects, method('a.b')); // [2, 1]Related Functions
attempt
Attempts to invoke func, returning either the result or the caught error object.
bindAll
Binds methods of an object to the object itself, overwriting the existing method.
cond
Creates a function that iterates over pairs and invokes the corresponding function of the first predicate to return truthy.
conforms
Creates a function that invokes the predicate properties of source with the corresponding property values of a given object.
constant
Creates a function that returns value.
defaultTo
Checks value to determine whether a default value should be returned in its place.