x-utils-s Base64与文件互转

Base64、ArrayBuffer、本地文件互转。由原 x-base64toarraybuff-s、x-base642file-s 合并，接口改为 DCloud 风格 success / fail / complete。

兼容性

Harmony	IOS	Android	WEB	小程序
支持	支持	支持	支持	支持

调用

import { base64ToArrayBuffer, arrayBufferToBase64, base64ToFile } from "@/uni_modules/x-utils-s"

base64ToArrayBuffer({
  base64: "SGVsbG8gV29ybGQ=",
  success: (res) => {
    console.log(res.data.byteLength)
  }
})

arrayBufferToBase64({
  arrayBuffer: res.data,
  success: (out) => {
    console.log(out.base64)
  }
})

base64ToFile({
  base64: "data:image/png;base64,iVBORw0KGgo...",
  fileName: "demo.png",
  success: (file) => {
    console.log(file.tempFilePath, file.size)
  },
  fail: (err) => {
    console.log(err.errCode, err.errMsg)
  }
})

方法

名称	说明
base64ToArrayBuffer	Base64 转 ArrayBuffer，支持 data: 前缀
arrayBufferToBase64	ArrayBuffer 转 Base64
base64ToFile	Base64 写入缓存文件。Web 返回 blob URL

base64ToFile

字段	说明
base64	必填，纯 Base64 或 data URI
fileName	可选。不传则按 mime 生成 x-utils-时间戳.ext

成功结果：tempFilePath、size、name、mimeType。

• Android / Harmony：应用缓存目录 x-utils/
• iOS：应用 Caches
• 微信：wx.env.USER_DATA_PATH
• Web：blob: 地址

不再强制重编码为 PNG，按原始字节落盘，扩展名跟 data URI 的 mime 走。

错误码

码	含义
1001	系统错误
1002	参数错误
1009	转换或写入失败

版本

版权归 https://xui.tmui.design 你不得修改及二次开发，仅供 TMUI4 会员商用使用。不得转给非 VIP 会员使用，一经查实数倍赔偿，并追究法律责任。

更新日志

1.0.0（2026-08-16）

• 合并原 x-base64toarraybuff-s、x-base642file-s
• 统一为 DCloud 风格 success / fail / complete
• 提供 base64ToArrayBuffer、arrayBufferToBase64、base64ToFile