Creates a Lodash wrapper around value to enable implicit method chain sequences. Some results auto-unwrap; others need .value(). Part of Lodash 4.x Seq (the main _ function).
Pass the value you want to wrap or transform. Finish with .value() when the result stays wrapped.
Call _(value). Start with this line.
_(value)| Call | What it does |
|---|---|
_(value) | Primary signature. |
Prefer import _ from "lodash" (full build) when you need wrapping and chaining.
_(value)| Parameter | Description |
|---|---|
| value | Required. Value to wrap |
| Return Value | Description |
|---|---|
| * | Lodash wrapper (implicit chain) |
Show auto-unwrap versus a wrapped collection.
function square(n) {
return n * n;
}
var wrapped = _([1, 2, 3]);
wrapped.reduce(_.add);
// → 6
var squares = wrapped.map(square);
_.isArray(squares);
// → false
_.isArray(squares.value());
// → true_([1, 2, 3]) starts an implicit sequence.6.squares.value() is a real array.Collection steps need an explicit unwrap at the end.
_([1, 2, 3, 4])
.map(function (n) { return n * 2; })
.filter(function (n) { return n > 5; })
.value();
// → [6, 8][2, 4, 6, 8].> 5 — still wrapped._().headSingle-value methods often end the chain for you.
_([10, 20, 30]).head();
// → 10
_([10, 20, 30]).map(function (n) { return n + 1; }).head();
// → 11.value() needed._.chain, head would still need .value()._.chainSame start, different unwrap rules.
_([1, 2, 3]).head();
// → 1
_.chain([1, 2, 3]).head().value();
// → 1
typeof _.chain([1, 2, 3]).head().value;
// → "function" // still a wrapper before .value()head returns 1..value().head is still a wrapper._() for short flows; _.chain when every step must stay chainable.tapSide-effect mid-pipeline without changing the value.
var seen = null;
_([1, 2, 3])
.map(function (n) { return n * 2; })
.tap(function (arr) { seen = arr.slice(); })
.filter(function (n) { return n > 2; })
.value();
// → [4, 6]
seen;
// → [2, 4, 6]_(value) is the main Lodash 4.x entry point (Seq/wrapper). It runs anywhere full Lodash runs — modern browsers (CDN or bundle) and Node.js / Bun / Deno with npm install lodash. There is no native Lodash-style wrapper — use nested calls or array methods instead.
Available as the default lodash export and via CDN. Wrapper chaining expects a full Lodash build. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production with full Lodash. Prefer _(value) for short implicit pipelines; use _.chain when you need explicit unwrap control.
Explore .value(), .commit(), .plant(), and other wrapper methods.
9 people found this page helpful