Enables explicit method chaining on an existing Lodash wrapper (from _(value)). Methods that would auto-unwrap in hybrid mode (like head) stay wrapped until .value(). Part of Lodash 4.x Seq / wrapper prototype.
Call it on a Lodash wrapper. Finish with .value() when you need a plain result.
Call .chain(). Start with this line.
_(value).chain()…value()| Call | What it does |
|---|---|
_(value).chain()…value() | Primary signature. |
Prefer import _ from "lodash" (full build) when you need wrapper prototype helpers.
_(value).chain()…value()| Parameter | Description |
|---|---|
| Wrapper | Required. From _(value) |
| .value() | Required. Plain JavaScript result |
| Return Value | Description |
|---|---|
| * | The value returned by .chain(). |
Explicit mode lets head stay wrapped so pick works.
var users = [
{ user: "barney", age: 36 },
{ user: "fred", age: 40 }
];
_(users)
.chain()
.head()
.pick("user")
.value();
// → { user: "barney" }_(users) starts hybrid.user, then unwraps..chain()Hybrid head ends the sequence early.
var users = [
{ user: "barney", age: 36 },
{ user: "fred", age: 40 }
];
_(users).head();
// → { user: "barney", age: 36 } // plain object
_(users).chain().head().pick("user").value();
// → { user: "barney" }head auto-unwraps..pick on a plain object..chain() keeps head wrapped.A short pipeline that stays explicit end-to-end.
var users = [
{ name: "Alice", age: 28 },
{ name: "Bob", age: 17 },
{ name: "Carol", age: 35 }
];
_(users)
.chain()
.filter(function (u) { return u.age >= 18; })
.map("name")
.value();
// → ["Alice", "Carol"]name — still wrapped._.chain()Same result; different entry point.
var users = [
{ user: "barney", age: 36 },
{ user: "fred", age: 40 }
];
var mid = _(users).chain().head().pick("user").value();
var start = _.chain(users).head().pick("user").value();
JSON.stringify(mid) === JSON.stringify(start);
// → true_(v).chain() toggles explicit mid-wrap._.chain(v) starts explicit..value() at the end._.chain if the whole pipeline is explicit.Check that explicit head returns a wrapper.
var users = [
{ user: "barney", age: 36 },
{ user: "fred", age: 40 }
];
typeof _(users).head();
// → "object" // plain user
typeof _(users).chain().head().value;
// → "function" // still a Lodash wrapper"object"..value.typeof …value is "function" before unwrap..value() when you need plain data.Wrapper .chain() ships with Lodash 4.x Seq. It runs anywhere full Lodash runs — modern browsers (CDN or bundle) and Node.js / Bun / Deno with npm install lodash. Modular lodash/* imports typically omit wrapper chaining.
Available on wrappers from _(value) in [email protected] full builds. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production with full Lodash. Use when hybrid auto-unwrap would break the next step; otherwise prefer _(v) or _.chain(v).
Run pending chain actions eagerly while keeping the wrapper.
9 people found this page helpful