# [Command](/minigame/dev/wxcloud/reference-sdk-api/database/Command).unshift(values: any[]): [Command](/minigame/dev/wxcloud/reference-sdk-api/database/Command)

> 支持端：[小程序](/miniprogram/dev/framework/client-lib/version.md), [云函数](/minigame/dev/wxcloud/reference/changelog-server-sdk), [Web](/minigame/dev/wxcloud/reference/changelog-web-sdk)

数组更新操作符，对一个值为数组的字段，往数组头部添加一个或多个值。或字段原为空，则创建该字段并设数组为传入值。

## 参数

### values: any[]

## 返回值

### [Command](/minigame/dev/wxcloud/reference-sdk-api/database/Command)

## 示例代码

```js
const _ = db.command
db.collection('todos').doc('doc-id').update({
  data: {
    tags: _.unshift(['mini-program', 'cloud'])
  }
})
```
