# 获取云侧文件列表

开发者可以获取指定云侧目录下所有的文件信息，包括文件存储目录、文件名称等。

#### 约束与限制

支持Phone、Tablet设备。并且从5.1.0(18)版本开始，新增支持Wearable设备；从5.1.1(19)版本开始，新增支持TV设备；从6.1.0(23)版本开始，新增支持PC/2in1设备。

#### 前提条件

*   已初始化存储实例。
    
*   已上传指定文件至云侧。
    

#### 操作步骤

调用StorageBucket.list可以获取云侧指定目录的文件列表。

完整示例代码如下：

```
import { cloudStorage } from '@kit.CloudFoundationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let storageBucket: cloudStorage.StorageBucket = cloudStorage.bucket();

@Component
export struct testPage {
  build() {
  }

  // 获取文件列表
  getList() {
    // 获取云存储默认实例中根路径下的文件列表
    storageBucket.list('').then((result: cloudStorage.ListResults) => {
      hilog.info(0x0000, 'testTag', `Succeeded in listing files, result: ${JSON.stringify(result)}`);
    }).catch((err: BusinessError) => {
      hilog.error(0x0000, 'testTag', `Failed to list files, code: ${err.code}, message: ${err.message}`);
    })
  }
}
```

获取文件列表信息结构如下：

```
{
  directories: ["empty-dir1\/", "screenshot\/"],
  files: ["IMG_20240229_103118.jpg", "IMG_20240318_093732.jpg"]
}
```