小程序开放平台

文档中心
基础
界面
网络
数据缓存
媒体
位置
开放接口
设备
XHSML
性能
文件
removeSavedFile
openDocument
getFileSystemManager
FileSystemManager
Stats
FileStats
chooseWeChatFile
chooseSystemFile
画布

xhs.chooseSystemFile

开发
>
JS API
>
文件
>
chooseSystemFile
>
更新时间:2025-10-09 14:25:43

参数

入参 Object object

属性
类型
必填
说明
typestring选择的文件类型, 可选值:all-全部类型文件、video-视频类型文件、image-图片类型文件、file-非图片、视频的其他文件
extensionArray扩展,仅当fileType = file时生效
successfunction接口调用成功的回调函数
failfunction接口接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

出参 Object object

属性
类型
说明
tempFilesarraypath - string - xhsfile://tmp...存储在Tmp目录下的文件地址 fileName - string - 文件名称 fileSize - string - 文件的大小,字节为单位

示例代码

xhs.chooseSystemFile({
      type: "all",
      success: (result) => {
        console.log('选择成功:', result);

        this.setData({
          resultInfo: JSON.stringify(result, null, 2)
        });

        xhs.showToast({
          title: `成功选择${result.tempFiles?.length || 0}个文件`,
          icon: 'success'
        });
      },
      fail: (error) => {
        console.error('选择文件失败:', error);
        this.setData({
          resultInfo: `错误: ${error.errMsg || error.message || error}`
        });

        xhs.showToast({
          title: error.errMsg || error.message || '选择文件失败',
          icon: 'none'
        });
      }
    }
);

api调用演示