@heybox/hb-sdk API Reference - v0.9.5
    正在准备搜索索引...

    类型别名 MiniProgramSDKHandshakeState

    MiniProgramSDKHandshakeState:
        | { status: "connecting" }
        | { status: "ready" }
        | { error: HbMiniProgramSDKError; status: "failed" }

    SDK 与 Host 握手的持久状态。

    状态是按 status 判别的只读联合类型:

    • connecting:默认 SDK 已开始初始握手但尚未落定;
    • ready:初始握手已成功;
    • failed:初始握手已失败,error 是导致失败的原始 HbMiniProgramSDKError。

    新实例只会从 connecting 迁移一次到 ready 或 failed,终态不会回退或互相转换;重复的 ready 事件也不会建立第二次状态迁移。每个状态 wrapper 都经过 Object.freeze(),调用方不能 替换 status 或 failed.error;冻结是浅层的,error 保留原始实例而不是克隆或冻结副本。

    ready 只记录初始握手已经成功,不是 Runtime 的持续存活探针;后续收到 unload 或销毁实例时 仍不会回退。该持久状态适合驱动交互控件;生命周期 ready 事件只是一条不会向晚订阅者重放的 边沿通知,不能替代当前状态。