WebTransport：来源、流与隐私边界
理解 WebTransport 的安全上下文、流语义、来源策略与 BotBrowser 能力边界。
BotBrowser Team
WebTransport 是浏览器向服务器建立安全、多路复用通信的 API。关键结论是有条件的：页面必须在受支持的安全上下文中创建 WebTransport，而连接成功并不代表授权、对端身份或应用隐私已经得到保证。BotBrowser 可以重复经过授权的浏览器配置流程来收集兼容性证据，但不能授予权限、绕过来源策略、查看其他来源的会话，或证明服务器安全处理数据。
要点
- 检测
WebTransport，要求安全上下文，并把连接拒绝作为正常产品状态处理。 - 会话同时支持双向流和数据报；有序性与可靠性是不同选择。
- 同源策略和服务器授权仍然有效；传输成功不是身份或隐私保证。
- 只记录支持所需的最小结果，不要把连接元数据变成长驻指纹。
- BotBrowser 可重复授权流程，但页面、服务器、代理和保留策略仍各自负责。
Contents
导航：API 契约、连接夹具、来源与隐私边界、决策矩阵、结论和常见问题。
API 保证什么
W3C 规范定义了安全、按来源隔离的客户端 API。new WebTransport(url) 创建候选会话；ready 在会话建立后解析，closed 报告最终关闭。流提供背压以及可靠、有序的字节；数据报是独立消息，不保证到达或顺序。API 不定义登录、消息格式、访问控制或服务器保留期限。URL 通常必须使用 https:。证书、代理、HTTP/3 协商或策略都可能导致拒绝，应分别分类而不是统称浏览器不兼容。
受控连接夹具
async function openSession(url, report) {
if (!('WebTransport' in globalThis)) return report({ state: 'unsupported' });
try {
const transport = new WebTransport(url);
await transport.ready;
report({ state: 'ready' });
transport.closed.finally(() => report({ state: 'closed' }));
} catch (error) {
report({ state: 'rejected', code: error?.name || 'connection-error' });
}
}
预期结果是 unsupported、ready 后接 closed，或 rejected。ready 只证明测试页面和端点在当前条件下建立了会话，不证明数据报到达、流获得授权或后端提交了记录。需要这些结论时，加入合成回显和应用超时。
来源与隐私边界
来源是发起会话页面的浏览器安全边界。CORS 不会自动使任意端点变成可信应用；服务器仍须认证和授权每个操作。不要把访问令牌放进 URL，也不要把远端主机名当作账户身份的证明。连接时序、关闭代码、协议协商和网络路径会随浏览器、代理、系统和负载变化，它们是运行观察，不是推断个人或设备的依据。遥测只保留会话状态、夹具版本、发布标签和粗粒度失败类别。
BotBrowser 的能力边界同样明确：它可以在声明的浏览器版本、平台和代理配置下重复授权配置流程；不能暴露其他来源会话、关闭 TLS 校验、强迫服务器接受 HTTP/3、保证数据报送达，或认证服务器保留与授权。报告测试的路由和回退，而不是普遍 WebTransport 保证。
证据与决策矩阵
使用受控端点、合成载荷和固定浏览器/配置运行夹具，只记录页面来源、端点类别、安全上下文、会话和流/数据报结果、关闭原因及展示的回退，不记录凭据或载荷内容。
| 观察 | 稳妥解释 | 下一步 |
|---|---|---|
unsupported | 当前上下文没有 API | 保留 WebSocket 或 HTTPS 回退并说明限制 |
ready 前 rejected | 上下文、证书、代理、策略或协商失败 | 分类失败并进行受控复测 |
ready 且流回显成功 | 此路径支持测试的可靠流 | 保留背压和超时并测试重连 |
| 数据报回显丢失 | 数据报语义或路径允许丢失 | 必需消息使用流并显示降级状态 |
应用超时后 closed | 会话结束，业务结果可能未知 | 用幂等键对账后再重试 |
矩阵把可观察结果连接到产品决定。浏览器、配置、代理、端点或服务器改变时逐项复测，一次只改一个变量。
结论
当安全来源、流、数据报和服务器契约符合任务时才使用 WebTransport。检测能力、保留可用回退并记录有界证据。下一步是在真实页面来源运行合成回显夹具，验证重连和未知结果恢复，而不是只检查构造函数存在。
常见问题
WebTransport 会替代认证吗？
不会。服务器仍需认证、授权、校验并记录应用消息。
数据报可靠吗？
不可靠，可能丢失或乱序。必须有序到达的数据使用双向流。
会话成功等于隐私得到保证吗？
不等于。负载处理、日志、代理可见性、保留期限和访问控制是独立决定。
BotBrowser 能强制解除阻断吗？
不能。它只能重复授权流程收集证据，不能绕过安全上下文、来源、证书、代理或服务器策略。