Like _.min, except it accepts an iteratee that ranks each element. Returns the original element with the lowest score. Part of Lodash Math since 4.0.0 (stable — not deprecated). The iteratee is called with one argument: (value).
Pass the numbers or collection shown below. Check the return value before you chain another math helper.
Call _.minBy. Start with this line.
_.minBy(array, iteratee)| Call | What it does |
|---|---|
_.minBy(array, iteratee) | Primary signature. |
Prefer import minBy from "lodash/minBy" when you want a smaller bundle.
_.minBy(array, iteratee)| Parameter | Description |
|---|---|
| array | Required. Array to iterate over |
| iteratee | Optional. Function or property path; invoked as (value) |
| Return Value | Description |
|---|---|
| * | The minimum element, or undefined if empty/falsey |
Return the field used to rank each object.
var objects = [{ n: 1 }, { n: 2 }];
console.log(_.minBy(objects, function (o) {
return o.n;
})); // { n: 1 }n.o.n for ranking.1 is less than 2.1.Pass the field name as a string — same result.
var objects = [{ n: 1 }, { n: 2 }];
console.log(_.minBy(objects, "n")); // { n: 1 }'n' is the _.property iteratee.o.n for each object.{ n: 1 }.Dotted paths drill into nested objects.
var products = [
{ name: "A", price: { base: 30 } },
{ name: "B", price: { base: 10 } },
{ name: "C", price: { base: 20 } }
];
console.log(_.minBy(products, "price.base"));
// → { name: "B", price: { base: 10 } }'price.base' reads the nested number.30, 10, 20.10 wins → product B.Like _.min, there is no minimum to return.
console.log(_.minBy([], "n")); // undefined
console.log(_.minBy(null, "n")); // undefinedundefined.undefined.?? fallback when you need a stand-in._.min vs _.minByFlat numbers use min; object fields use minBy.
var nums = [4, 2, 8, 6];
var objects = [{ n: 4 }, { n: 2 }, { n: 8 }, { n: 6 }];
console.log(_.min(nums)); // 2
console.log(_.minBy(objects, "n")); // { n: 2 }_.min returns the smallest number._.minBy returns the object that owns the smallest n.min; properties → minBy._.minBy is a Lodash Math helper (available since 4.0.0, stable in 4.x). It runs anywhere Lodash runs — modern browsers (via CDN or bundle) and Node.js / Bun / Deno with npm install lodash. Native alternatives map then reduce; Lodash adds iteratee shorthands.
Available in [email protected] full builds and the lodash/minBy modular import. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production once Lodash is on the page or in your bundle. Prefer import minBy from "lodash/minBy" for smaller builds. Use property shorthand for simple fields; use a function for computed ranks.
Multiply two numbers with Lodash.
10 people found this page helpful