跳到主要内容

createSessionId()

function createSessionId(): string;

Defined in: v2/ids.ts:35

生成 canonical UUID v4 作为 sessionId。

Returns​

string

形如 xxxxxxxx-xxxx-4xxx-[89ab]xxx-xxxxxxxxxxxx 的小写 UUID。

Remarks​

刻意不使用 crypto.randomUUID()。 connector 运行在被检查页面里,而 DevTools 扩展显式 接受 http: 页面;在 http://192.168.1.10:4200 这类局域网 dev server 上,页面不是安全上下文, crypto.randomUUID 是 undefined,session 会在真实使用场景里直接建不起来。

同样不回落 Math.random():sessionId 参与「旧 session 消息一律拒绝」的判定, 可预测的值会让轮换失去意义。getRandomValues 不可用时宁可抛错,也不静默降级。

Throws​

TypeError 当宿主未提供 crypto.getRandomValues 时。