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

# Response Query

The `res` object that is available inside the [vars](../vars), [assertions](../../tests/assertions), [scripting](../getting-started) and [testing](../../tests/introduction) contexts can be queried for data by invoking it like below.

Think of it as `lodash.get()` on steroids

```javascript theme={null}
res('order.total')
```

## Examples

```javascript theme={null}
const data = {
  customer: {
    address: {
      city: "bangalore"
    },
    orders: [
      {
        id: "order-1",
        items: [
          { id: 1, amount: 10 },
          { id: 2, amount: 20 }
        ]
      },
      {
        id: "order-2",
        items: [
          { id: 3, amount: 30 },
          { id: 4, amount: 40 }
        ]
      }
    ]
  },
};
```

| Query                                   | Output                              |   |
| --------------------------------------- | ----------------------------------- | - |
| res("customer.address.city")            | bangalore                           |   |
| res("customer.orders.items.amount")     | \[10, 20, 30, 40]                   |   |
| res("customer.orders.items.amount\[0]") | 10                                  |   |
| res("..items.amount")                   | \[10, 20, 30, 40]                   |   |
| res("..amount")                         | \[10, 20, 30, 40]                   |   |
| res("..items.amount\[0]")               | 10                                  |   |
| res("..items\[0].amount")               | 10                                  |   |
| res("..items\[5].amount")               | undefined                           |   |
| res("..id")                             | \["order-1", 1, 2, "order-2", 3, 4] |   |
| res("customer.orders.foo")              | undefined                           |   |
| res("..customer.foo")                   | undefined                           |   |
| res("..address")                        | \[\{ city: "bangalore" }]           |   |
| res("..address\[0]")                    | \{ city: "bangalore" }              |   |

## API

### Standard dot notation

**Example:**

```javascript theme={null}
res('customer.orders.items.amount')
```

### Deep navigation .. double dots

**Example:**

```javascript theme={null}
res('..items.amount')
```

### Array indexing

**Example:**

```javascript theme={null}
res('..items[0].amount')
```

### Array filtering \[?] with corresponding filter function

**Example:**

```javascript theme={null}
res('..items[?].amount', i => i.amount > 20)
```

### Array mapping \[?] with corresponding mapper function

**Example:**

```javascript theme={null}
res('..items..amount[?]', amt => amt + 10)
```
