# Object.filter

## 功能

筛选让回调结果为真的键值对，并返回新对象。

## 语法

```bt
object.filter(callback)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| callback | Fn | 否 | Empty | 回调签名为 fn(value, key, current)。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Object | 返回筛选后的新对象。 |

## 返回对象字段

返回对象只包含原对象中让回调结果为真的字段。字段名保持不变，字段值保持原值；未通过筛选的字段不存在，读取结果为 `empty`。

## 示例

```bt
data = {a: 1, b: 2, c: 3}
result = data.filter(fn(value) { value > 1 })

// 输出：{"b":2,"c":3}
print result
```

## 注意事项

- filter 不修改原对象。
- 回调遍历的是开始调用时的对象快照。