跳到主要内容

assertUsableBranchId()

function assertUsableBranchId(branchId): void;

Defined in: packages/rxdb/src/system/active-branch-guard.ts:105

校验分支 id 可用,不可用即抛。

Parameters​

ParameterTypeDescription
branchIdstring待校验的分支 id

Returns​

void

Throws​

InvalidBranchIdError id 为空 / 纯空白 / 含保留字符 * 时

Remarks​

放在哨兵常量同一个文件里,是因为它兑现的正是 ACTIVE_BRANCH_KEY 那段 TSDoc 立下的承诺。拆到 version/create-branch.ts 之类的调用点旁边,改哨兵形状的人 就看不到这条规则了,而那恰恰是唯一需要同步改的时刻。

校验点是创建与导入边界,不是每次读写:id 一旦落库就不再变,在读路径上重复校验 只会把「历史遗留的坏数据」变成「整个库打不开」。已经躺在库里的坏 id 由 assertSingleActiveBranch 那条基数不变量兜底。