assertUsableBranchId()
function assertUsableBranchId(branchId): void;
Defined in: packages/rxdb/src/system/active-branch-guard.ts:105
校验分支 id 可用,不可用即抛。
Parameters
| Parameter | Type | Description |
|---|---|---|
branchId | string | 待校验的分支 id |
Returns
void
Throws
InvalidBranchIdError id 为空 / 纯空白 / 含保留字符 * 时
Remarks
放在哨兵常量同一个文件里,是因为它兑现的正是 ACTIVE_BRANCH_KEY 那段
TSDoc 立下的承诺。拆到 version/create-branch.ts 之类的调用点旁边,改哨兵形状的人
就看不到这条规则了,而那恰恰是唯一需要同步改的时刻。
校验点是创建与导入边界,不是每次读写:id 一旦落库就不再变,在读路径上重复校验 只会把「历史遗留的坏数据」变成「整个库打不开」。已经躺在库里的坏 id 由 assertSingleActiveBranch 那条基数不变量兜底。