获取云侧文件列表
========

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

#### 约束与限制

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

#### 前提条件

*   已[初始化存储实例](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-storage-initialize-bucket)。
    
*   已[上传指定文件至云侧](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/cloudfoundation-storage-upload-file)。
    

#### 操作步骤

调用[StorageBucket.list](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/cloudfoundation-cloudstorage#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"\]
}