`batchSetStorageSync` 参数类型错误

[skr2005]

请先确认

• 我已搜索并确定这个提交不是重复的

Taro 版本

v4

相关领域

TypeScript 类型

使用框架

React

相关平台

• 所有平台
• Web 端（H5）
• 移动端（React-Native）
• 鸿蒙（Harmony）
• 鸿蒙容器（Harmony Hybrid）
• ASCF 元服务
• 快应用（QuickApp）
• 所有小程序
• 微信小程序
• 企业微信小程序
• 京东小程序
• 百度小程序
• 支付宝小程序
• 支付宝 IOT 小程序
• 头条小程序
• QQ 小程序
• 钉钉小程序
• 飞书小程序
• 快手小程序

小程序基础库版本

3.14.2

问题描述

当前Taro.batchSetStorageSync的参数类型为{kvList: {key: string; value: any}[]}，然而若按此类型填入参数，微信小程序可见如下报错：

Error: parameter error: parameter should be Array instead of Object;
    at o (WAServiceMainContext.js?t=wechat&v=3.14.2:1)
    at Object.batchSetStorageSync (WAServiceMainContext.js?t=wechat&v=3.14.2:1)
    at e.<computed> (WAServiceMainContext.js?t=wechat&v=3.14.2:1)
    at Object.HX.<computed> (WAServiceMainContext.js?t=wechat&v=3.14.2:1)
    at k (WAServiceMainContext.js?t=wechat&v=3.14.2:1)
    at Object.p (WAServiceMainContext.js?t=wechat&v=3.14.2:1)
    at Object.p (VM59 WASubContext.js:1)
    at Object.value [as batchSetStorageSync] (index.js:1)
    at Object.t.<computed> [as batchSetStorageSync] (taro.js?t=wechat&s=1772183740675&v=874cf23e0564be1994cbbd6103d94e20:2)
    at h (common.js?t=wechat&s=1772183740675&v=6fc5c2f1bc5d312cd205cbccd7709c57:2)(env: Windows,mp,2.01.2510250; lib: 3.14.2)

事实上，Taro.batchSetStorageSync文档的示例代码中的参数类型为{key: string; value: any}[]，这和类型声明不一致，但是和wx.batchSetStorageSync一致。当按照示例代码调用时，小程序不会出现运行时错误，但是由于参数和typescript声明冲突，代码不能通过tsc编译。

复现链接

暂无

复现步骤

在微信小程序项目中调用

Taro.batchSetStorageSync({kvList: [{key: 'key', value: 'value'}]})

环境信息

Taro CLI 4.1.11 environment info:
    System:
      OS: Windows 11 10.0.26200
    Binaries:
      Node: 24.12.0 - C:\nvm4w\nodejs\node.EXE
      npm: 11.6.2 - C:\nvm4w\nodejs\npm.CMD
    npmPackages:
      @tarojs/cli: ^4.1.1 => 4.1.11
      @tarojs/components: ^4.1.1 => 4.1.11
      @tarojs/helper: ^4.1.7 => 4.1.11
      @tarojs/plugin-framework-react: ^4.1.1 => 4.1.11
      @tarojs/react: ^4.1.1 => 4.1.11
      @tarojs/runtime: ^4.1.1 => 4.1.11
      @tarojs/taro: ^4.1.1 => 4.1.11
      @tarojs/webpack5-runner: ^4.1.1 => 4.1.11
      babel-preset-taro: ^4.1.11 => 4.1.11
      react: ^18.2.0 => 18.3.1

开源贡献

• 我愿意修复这个错误。请参考 (贡献指南)