抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • C# API
  • 开放接口
  • 转发
  • 群聊
  • 关注
  • 数据分析
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 转发
  • 数据缓存
  • 本地数据缓存
  • tt.clearStorage
  • tt.clearStorageSync
  • tt.getStorage
  • tt.getStorageSync
  • tt.getStorageInfo
  • tt.getStorageInfoSync
  • tt.removeStorage
  • tt.removeStorageSync
  • tt.setStorage
  • tt.setStorageSync
  • 广告
  • 界面
  • 支付
  • Worker
  • tt.setStorageSync
    收藏
    我的收藏

    基础库 1.0.0 开始支持本方法,这是一个同步方法。

    以「键值对」的形式设置本地缓存数据。这是一个同步接口,是tt.setStorage的同步版本。

    前提条件
    业务背景
    使用限制
    注意事项
    • 将数据存储在本地缓存中指定的 key 中。如果之前存在同名 key,会覆盖掉原来该 key 对应的内容。
    相关教程

    语法

    tt.setStorageSync(key, rawData)

    参数说明

    key

    类型默认值必填说明最低支持版本
    string

    键名

    1.0.0

    rawData

    类型默认值必填说明最低支持版本
    string | number | boolean | object | null | undefined1.0.0

    返回值

    错误码

    errNoerrMsg说明最低支持版本
    21101exceed storage item max length
    1.0.0
    21102exceed storage max size %sMb
    1.0.0
    21103set storage fail
    小游戏框架内部错误,有需要请创建工单咨询
    1.0.0
    20000internal error
    小游戏框架内部错误,有需要请创建工单咨询
    1.0.0
    20001invalid param
    参数错误
    1.0.0
    -1promise not call
    小游戏框架内部错误,有需要请创建工单咨询
    1.0.0
    20000key is illegal
    1.0.0
    10102Methord %@ not implement
    小游戏框架内部错误,有需要请创建工单咨询
    1.0.0
    20000dataType is illegal
    1.0.0
    21000exceed storage item max length
    1.0.0
    21000exceed storage max size 10Mb
    1.0.0
    21000localStorage setObject failed, data: %@; key: %@
    小游戏框架内部错误,有需要请创建工单咨询
    1.0.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    try { tt.setStorageSync("didShownAd", false); } catch (error) { console.log(`setStorageSync调用失败`); }