Creates a clone of the chain sequence, planting a new value as the wrapped value. Queued actions (like .map) stay; only the starting data changes. Call it on a Lodash wrapper from _(value) or _.chain(value). Part of Lodash Seq (since 3.2.0).
Call it on a Lodash wrapper. Finish with .value() when you need a plain result.
Call _.prototype.plant(). Start with this line.
wrapper.plant(value)| Call | What it does |
|---|---|
wrapper.plant(value) | Primary signature. |
Prefer import _ from "lodash" (full build) when you need wrapper prototype helpers.
wrapper.plant(value)| Parameter | Description |
|---|---|
| Receiver | Required. A Lodash wrapper with queued actions |
| value | Required. New data to plant as the wrapped value |
| Return Value | Description |
|---|---|
| * | New wrapper (clone of the chain) |
plantReuse map(square) on a new array.
function square(n) {
return n * n;
}
var wrapped = _([1, 2]).map(square);
var other = wrapped.plant([3, 4]);
other.value();
// → [9, 16]map(square) on [1, 2].[3, 4].other.value() squares each planted number.Planting does not change the first wrapper’s result.
function square(n) {
return n * n;
}
var wrapped = _([1, 2]).map(square);
var other = wrapped.plant([3, 4]);
[
other.value(),
wrapped.value()
];
// → [[9, 16], [1, 4]]other is a separate wrapper.[3, 4] → [9, 16].[1, 2] → [1, 4].Reuse more than one queued step.
var pipeline = _([1, 2, 3, 4])
.filter(function (n) { return n % 2 === 0; })
.map(function (n) { return n * 10; });
var other = pipeline.plant([5, 6, 7, 8]);
other.value();
// → [60, 80][5, 6, 7, 8].6, 8.60, 80.plant vs New ChainSame result; plant reuses the built pipeline.
function square(n) {
return n * n;
}
var wrapped = _([1, 2]).map(square);
[
wrapped.plant([3, 4]).value(),
_([3, 4]).map(square).value()
];
// → [[9, 16], [9, 16]]map(square) queue.[9, 16].plant when the pipeline is already built and complex.The planted result is still a wrapper — keep chaining.
function square(n) {
return n * n;
}
var wrapped = _([1, 2]).map(square);
wrapped.plant([3, 4]).reverse().value();
// → [16, 9][3, 4] with map(square)..reverse() flips the squared list..value() → [16, 9].Wrapper .plant() is a Lodash Seq prototype method (since 3.2.0). It needs no special browser APIs beyond loading Lodash.
Available in [email protected] full builds when using _(value) / _.chain(value). Works in evergreen browsers and Node / Bun / Deno when Lodash is installed.
Bottom line: Safe for production once Lodash is on the page or in your bundle. Prefer the full lodash build for Seq / wrapper APIs.
Reverse the wrapped array inside a Lodash chain.
6 people found this page helpful