内容提要
本文介绍如何在 Next.js 中使用 Chrome 内置的 Translator 与 Language Detector API 构建本地翻译应用:模型按需下载并在设备端运行,无需自建服务器或按请求付费。教程涵盖语言检测、流式翻译、下载进度与取消、复制与朗读、语言互换及不支持浏览器的降级处理,并说明需用户手势触发下载、仅限桌面 Chrome、翻译按顺序处理等限制。
延伸解读
本地翻译的隐私边界与成本优势
文章强调,Chrome 内置翻译模型在设备端运行,用户文本不会发送到翻译服务器,这降低了隐私风险。但需注意,首次使用某语言对时,Chrome 仍需联网下载语言包,因此并非完全离线。此外,开发者应确保自己的分析或错误日志不捕获用户翻译的文本,否则本地处理的隐私优势会被抵消。
语言检测与翻译支持的语言集不同
教程中的测试显示,Chrome 的语言检测器能识别豪萨语,但翻译器不支持该语言对。这意味着检测到的语言不一定可翻译。开发者需分别处理检测成功但翻译不可用的情况,并考虑为不支持的语言提供降级方案,如服务器端模型或云翻译 API。
用户手势与顺序处理对交互设计的影响
创建翻译器或检测器时,若需下载模型,必须由用户手势(如点击)触发,否则会抛出 NotAllowedError。同时,翻译请求按顺序处理,长文本会阻塞后续请求。因此,界面应在提交表单时调用翻译,并显示下载进度和加载状态,对长文本分块处理,避免用户误以为应用无响应。
生产环境需考虑的兼容性与资源管理
这些 API 仅限桌面版 Chrome 和 Edge,移动端及 Firefox、Safari 不支持。文章建议将其作为渐进增强,为不支持的浏览器提供回退方案,并明确告知用户文本是否会离开设备。此外,翻译器会占用较多资源,应在组件卸载时调用 destroy() 释放,并利用 inputQuota 检查输入长度,避免超限错误。
Q&A
Chrome 内置的 Translator 和 Language Detector API 有什么特别之处?
这两个 API 由 Chrome 按需下载小型专用模型并在用户设备上运行,无需自建模型托管或推理服务器,也不按请求付费。它们通过 JavaScript 调用,翻译和检测都在本地完成,用户文本不会发送到翻译服务器。
使用 Chrome 内置翻译 API 时有哪些必须注意的限制?
主要限制包括:创建翻译器或检测器需要用户手势(如点击)触发模型下载;API 不能在 Web Worker 中使用,只能在主线程调用;翻译按顺序处理,大请求会阻塞后续请求;默认仅支持顶层窗口和同源 iframe,跨域 iframe 需要 Permissions Policy。此外,这些 API 仅限桌面版 Chrome(138+)和 Edge,移动端、Firefox 和 Safari 不支持。
如何在 Next.js 中检测浏览器是否支持 Chrome 内置翻译 API?
可以编写一个特性检测函数,检查 self 上是否存在 Translator 和 LanguageDetector。在 Next.js 服务端渲染时,由于没有 self.Translator,该函数应返回 false。在客户端组件中,可以使用 useSyncExternalStore 分别提供客户端快照和服务端快照(返回 null),避免水合不匹配,然后根据结果展示翻译器或不支持提示。
Chrome 内置翻译 API 的 availability() 方法返回哪些状态?分别代表什么?
availability() 返回四种值:unavailable 表示浏览器不支持这些选项;downloadable 表示支持但需要先下载模型;downloading 表示支持且下载正在进行中;available 表示支持且已就绪无需下载。UI 应根据这些状态做出相应处理。
如何实现流式翻译并让用户取消正在进行的翻译?
使用 translator.translateStreaming(text, { signal }) 获取 ReadableStream,然后通过 getReader() 逐块读取并追加到输出状态,实现流式显示。取消时,调用 AbortController 的 abort() 方法,该 signal 会传入检测、下载和翻译的所有调用,从而中止整个流程。
语言检测的置信度低时应该如何处理?
语言检测结果是概率性的,短文本或单个词可能导致低准确率。可以设置一个置信度阈值(例如 0.6),当检测结果的置信度低于阈值时,抛出 LowConfidenceError,提示用户手动选择源语言,而不是依赖自动检测。
为什么需要调用 destroy() 释放翻译器?如何统一释放所有模型?
Translator 和 LanguageDetector 可能占用大量资源,MDN 建议在使用完毕后调用 destroy() 释放内存。可以编写一个 destroyAll() 函数,遍历所有缓存的翻译器并调用 destroy(),同时清空缓存,并处理检测器的 Promise,在组件卸载时调用该函数。