tt.getRandomValues

更新时间 2024-08-19 09:34:26
收藏
我的收藏

基础库 2.87.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。

获取安全学密码随机数。

前提条件
业务背景
使用限制
注意事项
支持沙盒
相关教程

语法

tt.getRandomValues(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
lengthnumber
生成随机数的字节数,最小值为1,最大值为1048576
2.87.0
successfunction
接口调用成功的回调函数
2.87.0
failfunction
接口调用失败的回调函数
2.87.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
2.87.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"getRandomValues:ok"
2.87.0
randomValuesarrayBuffer
随机数内容,长度为传入的字节数
2.87.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"getRandomValues:fail" + 详细错误信息
2.87.0

代码示例

tt.getRandomValues({
  length: 10,
  success: (res) => {
    console.log(tt.arrayBufferToBase64(res.randomValues));
  },
});