# 错误处理与日志约定

zWhiteBoard 是实时同步客户端，错误处理分两层：WS 客户端 fail-fast（关键路径抛错/记日志），UI 层捕获后写控制台。

## WS 客户端（src/composables/useWhiteboard.js）

- `send`：`ws.send` 序列化失败 `console.error`（WS 通常是 RUNNING 状态，此分支极少触发，但记日志便于定位）。
- `connect`：`new WebSocket()` 抛错 `console.error` + 安排重连（URL 非法或浏览器拦截时）。
- `ws.onerror`：透传 `console.error`（浏览器仅给泛化错误，无 detail，但能标记故障时间点）。
- `onMessage`：JSON.parse 失败 `console.warn` 后忽略（不抛错，避免单条坏消息中断后续同步）。
- `applyRemoteUpdate`：`setSelectionRange` 失败 `console.warn`（光标修复非致命，文本已正确替换）。
- `connectBoard`：GET `/api/wb/{id}` 预取失败 `console.warn`，仍尝试连 WS（预取仅为优化，WS init 帧会兜底下发内容）。
- `teardownSocket`：关闭旧 WS 出错 `console.warn`（清理路径，不应阻塞切换）。

## UI 层（src/App.vue）

- `onCopyText` / `onCopyLink`：剪贴板 API 拒绝时 `console.warn`（HTTPS/权限策略限制，非致命，不影响同步）。
- `onClear`：未连接直接 return（不发 clear）；用户取消确认框直接 return。

## 控制台前缀

所有 `[zWB]` 前缀的日志来自本子项目，便于嵌入宿主时与宿主日志区分。