---
title: "findByRange"
slug: "tools-findbyrange"
updated: 2025-11-06T19:00:44Z
published: 2025-11-06T19:00:44Z
canonical: "docs.doc-know.com/tools-findbyrange"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doc-know.com/llms.txt
> Use this file to discover all available pages before exploring further.

# findByRange

### tools.findByRange

Loops through each item in the passed array and returns the item that has a **range** that the specified **value** falls within.

### Input Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| **array** | Any | Yes | Array of JSON objects |
| **attrRange1** | Text | Yes | Property name whose numeric value indicates the start of the range |
| **attrRange2** | Text | Yes | Property name whose numeric value indicates the end of the range |
| **value** | Number | Yes | Numeric **value** that is checked whether or not it is within each item's numeric range |

### Returns

Type: **Any**

Returns the JSON object from the passed array whose **range** the specified **value** falls within.

### Examples

```
var items = [
    { "value1": 0, "value2": 19, "color": "Red" },
    { "value1": 20, "value2": 29, "color": "Green" },
    { "value1": 30, "value2": 39, "color": "Blue" },
    { "value1": 40, "value2": 49, "color": "Yellow" },
    { "value1": 50, "value2": 100, "color": "Orange" }
];

// find the item in the array whose range 32 falls within
// note: the entire object for 'Blue' is returned
var item = tools.findByRange(items, "value1", "value2", 32);
```

### Remarks

Use this function when you have an array of JSON objects and you want to find a particular object based on whether or not a specified **value** falls within a **numeric range** identified by two specified properties that exist on every object in the array.