# [AggregateCommand](AggregateCommand).strLenBytes(value: [Expression](/miniprogram/dev/wxcloudservice/wxcloud/reference-sdk-api/database/aggregate/Expression)): Object

> 支持端：[小程序 2.7.4](/miniprogram/dev/framework/client-lib/version.md), [云函数 0.8.1](/miniprogram/dev/wxcloudservice/wxcloud/reference/changelog-server-sdk), [Web](/miniprogram/dev/wxcloudservice/wxcloud/reference/changelog-web-sdk)

聚合操作符。计算并返回指定字符串中 `utf-8` 编码的字节数量。

## 参数

### value: [Expression](/miniprogram/dev/wxcloudservice/wxcloud/reference-sdk-api/database/aggregate/Expression)

表达式

## 返回值

### Object

## API 说明

`strLenBytes` 的语法如下：

```javascript
db.command.aggregate.strLenBytes()
```

只要表达式可以被解析成字符串，那么它就是有效表达式。

## 示例代码

假设集合 `students` 的记录如下：

```json
{ "name": "dongyuanxin", "nickname": "心谭" }
```

借助 `strLenBytes` 计算 `name` 字段和 `nickname` 字段对应值的字节长度：

```javascript
const $ = db.command.aggregate
db
  .collection('students')
  .aggregate()
  .project({
    _id: 0,
    nameLength: $.strLenBytes('$name'),
    nicknameLength: $.strLenBytes('$nickname')
  })
  .end()
```

返回结果如下：

```javascript
{ "nameLength": 11, "nicknameLength": 6 }
```