Creates an array of numbers progressing from start up to, but not including, end. Part of Lodash Util since 0.1.0 (stable — not deprecated).
Note: JavaScript follows IEEE-754 for floats, which can produce unexpected results with fractional steps.
Call _.range. Start with this line.
_.range([start=0], end, [step=1])| Call | What it does |
|---|---|
_.range([start=0], end, [step=1]) | Primary signature. |
_.range(...) | Call the util helper. |
Prefer import range from "lodash/range" when you want a smaller bundle.
_.range([start=0], end, [step=1])| Parameter | Description |
|---|---|
| start | Optional. Start of the range (default 0) |
| end | Required. End of the range (exclusive). *With one arg, that value is end |
| step | Optional. Increment/decrement (default 1) |
| Return Value | Description |
|---|---|
| * | Array of numbers |
Pass only end; start defaults to 0.
_.range(4);
// → [0, 1, 2, 3]
_.range(0);
// → []end.0 … end-1.4 itself is not included._.range(0) has nothing before the end → [].Set both bounds; end stays exclusive.
_.range(1, 5);
// → [1, 2, 3, 4]1.1.5.[1, 2, 3, 4].Jump by a custom increment.
_.range(0, 20, 5);
// → [0, 5, 10, 15]0.5, 10, 15.20 would be next but end is exclusive.Count down with a negative end or a negative step.
_.range(-4);
// → [0, -1, -2, -3]
_.range(0, -4, -1);
// → [0, -1, -2, -3]-1 toward that end._.range(0, -4, -1) does the same clearly.-4 is not included.[0, -1, -2, -3].A step of 0 repeats the start value.
_.range(1, 4, 0);
// → [1, 1, 1]1._.range is a Lodash Util helper since 0.1.0. It runs anywhere Lodash runs — modern browsers (CDN or bundle) and Node.js / Bun / Deno with npm install lodash.
Available in [email protected] full builds and the lodash/range modular import. Works in evergreen browsers and current Node LTS when Lodash is installed.
Bottom line: Safe for production once Lodash is loaded. Prefer import range from "lodash/range" for smaller bundles. End is exclusive; use integer steps for predictable sequences.
Generate the same numbers as _.range, filled from right to left.
10 people found this page helpful