gmkitx API - v0.10.1
    正在准备搜索索引...

    函数 getRandomBytes

    • 生成随机字节的跨平台函数。

      优先级(从高到低):

      1. setCustomRNG 显式注入 - 供小程序宿主接入平台 CSPRNG,也可用于测试 fixture

      2. Web Crypto API (crypto.getRandomValues) - 密码学安全的随机数生成器

        • 浏览器环境:window.crypto.getRandomValues
        • Node.js 15+:globalThis.crypto.getRandomValues
        • 这是最安全的方式,使用操作系统提供的 CSPRNG
      3. Node.js crypto.randomBytes - 兼容没有 globalThis.crypto 的旧版 Node.js/CJS

      4. 非安全 fallback - warn(默认)会提示一次,allow 静默兼容,strict 直接拒绝

      参数

      • len: number = 32

        需要的字节数,默认 32;必须是正安全整数

      返回 Uint8Array

      精确包含 len 个随机字节的 Uint8Array

      长度非法、自定义 RNG 返回类型/长度错误,或 strict 模式下没有 CSPRNG 时抛出错误