小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
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调用演示