Checks if n is between start and up to, but not including, end — a half-open interval [start, end). Part of Lodash Number (stable since 3.3.0 — not deprecated). If end is omitted, it becomes the second argument and start defaults to 0. If start > end, the params are swapped.
Pass the numbers shown below. Check bounds and return type before you use the result.
Call _.inRange. Start with this line.
_.inRange(number, [start=0], end)| Call | What it does |
|---|---|
_.inRange(number, [start=0], end) | Primary signature. |
Prefer import inRange from "lodash/inRange" when you want a smaller bundle.
_.inRange(number, [start=0], end)| Parameter | Description |
|---|---|
| number | Required. Value to check |
| start | Optional. Inclusive start (default 0 in two-arg form) |
| end | Required. Exclusive end of the range |
| Return Value | Description |
|---|---|
| * | true if in range, else false |
Test a number inside [start, end).
console.log(_.inRange(3, 2, 4)); // true2 (inclusive), end 4 (exclusive).2 <= 3 < 4.true — matches the official docs.When end is omitted, start becomes 0.
console.log(_.inRange(4, 8)); // true // 0 <= 4 < 8
console.log(_.inRange(4, 2)); // false // 0 <= 4 < 2_.inRange(4, 8) → 0 <= 4 < 8.4 is inside → true._.inRange(4, 2) → 0 <= 4 < 2 → false.The end value itself is outside the range.
console.log(_.inRange(2, 2)); // false
console.log(_.inRange(2, 0, 2)); // false
console.log(_.inRange(1, 0, 2)); // truenumber < end, not <=.2 is not less than 2 → false.1 in [0, 2) → true._.clamp treats both bounds as inclusive.Decimals work the same way.
console.log(_.inRange(1.2, 2)); // true // 0 <= 1.2 < 2
console.log(_.inRange(5.2, 4)); // false // 0 <= 5.2 < 40.1.2 is under 2.5.2 is not under 4.When start > end, Lodash swaps them.
console.log(_.inRange(-3, -2, -6)); // true
// after swap: -6 <= -3 < -2(-3, -2, -6).[-6, -2).-3 is inside → true._.clamp does not swap bounds this way._.inRange is a Lodash Number helper available since 3.3.0. It runs anywhere Lodash runs — modern browsers (via CDN or bundle) and Node.js / Bun / Deno with npm install lodash. Native equivalents use a comparison like start <= n && n < end (after handling defaults and swaps yourself).
Available in [email protected] full builds and the lodash/inRange 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 inRange from "lodash/inRange" for smaller builds. Remember: end is exclusive.
Generate a random number within a lower/upper range.
10 people found this page helpful