# Object.update

## 功能

把一个或多个对象原地合并到当前对象。

## 语法

```bt
object.update(source1, source2, ...)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| sourceN | Object | 否 | 无 | 要合并的来源对象；非对象参数会被忽略。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Object | 返回原对象，便于继续链式调用。 |

## 返回对象字段

`update()` 返回调用它的同一个对象引用。返回对象先保留原字段，再按参数顺序写入每个来源对象的字段；同名字段由后写入的来源对象覆盖。

## 示例

```bt
config = {host: '127.0.0.1'}
config.update({port: 8080})

// 输出：{"host":"127.0.0.1","port":8080}
echo(config)
```

## 注意事项

- update 会修改原对象。
- update 会拒绝写入会形成循环引用的值。