es-toolkit/dist/compat/util/invoke.js

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

const require_toKey = require("../_internal/toKey.js");
const require_toPath = require("./toPath.js");
const require_get = require("../object/get.js");
const require_last = require("../array/last.js");
//#region src/compat/util/invoke.ts
/**
* Invokes the method at `path` of `object` with the given arguments.
*
* @param object - The object to query.
* @param path - The path of the method to invoke.
* @param args - The arguments to invoke the method with.
* @returns Returns the result of the invoked method.
*
* @example
* const object = {
*   a: {
*     b: function (x, y) {
*       return x + y;
*     }
*   }
* };
*
* invoke(object, 'a.b', [1, 2]); // => 3
* invoke(object, ['a', 'b'], [1, 2]); // => 3
*/
function invoke(object, path, ...args) {
	args = args.flat(1);
	if (object == null) return;
	switch (typeof path) {
		case "string":
			if (typeof object === "object" && Object.hasOwn(object, path)) return invokeImpl(object, [path], args);
			return invokeImpl(object, require_toPath.toPath(path), args);
		case "number":
		case "symbol": return invokeImpl(object, [path], args);
		default: if (Array.isArray(path)) return invokeImpl(object, path, args);
		else return invokeImpl(object, [path], args);
	}
}
function invokeImpl(object, path, args) {
	const parent = require_get.get(object, path.slice(0, -1), object);
	if (parent == null) return;
	let lastKey = require_last.last(path);
	const lastValue = lastKey?.valueOf();
	if (typeof lastValue === "number") lastKey = require_toKey.toKey(lastValue);
	else lastKey = String(lastKey);
	return require_get.get(parent, lastKey)?.apply(parent, args);
}
//#endregion
exports.invoke = invoke;