Topics API 是 Chrome 专属的非标准 HTTPS JavaScript 接口，需调用 navigator.getInterestCohort() 获取单主题字符串，无跨浏览器支持，不可用于精准广告投放。
Topics API 不是 HTML 功能，不能通过 HTML 标签、属性或纯前端配置启用；它是一个仅限 HTTPS 的 Chrome 浏览器原生 JavaScript API，且目前默认禁用、非标准、无跨浏览器支持。
Topics API 必须用 navigator.getInterestCohort() 调用
HTML 中写 <script>navigator.getInterestCohort()</script> 没用——必须在安全上下文（HTTPS）中，由 JS 主动调用并处理 Promise。它不响应 HTML 属性（如 browsingTopics 属性在 <iframe> 中已被 Chrome 移除），也不接受任何 HTML 配置参数。
常见错误现象：
- 本地 HTTP 环境下直接调用返回
TypeError: getInterestCohort is not a function - 在 iframe 里设
browsingTopics属性，但 Chrome 125+ 已忽略该属性，控制台无报错也无效果 - 未 await 或 .then() 处理 Promise，直接读
cohort.topic得到undefined
正确做法：
立即学习“前端免费学习笔记（深入）”；
- 确保页面部署在 HTTPS 域名下（
http://localhost除外，开发可用） - 检查用户是否开启：Chrome 地址栏点击锁图标 → “网站设置” → “广告隐私” → 开启“允许网站查看您的兴趣”
- 只在需要时调用一次（每天最多一次有效请求），避免高频轮询
返回的 topic 是单个字符串，不是数组或完整画像
navigator.getInterestCohort() 返回的是一个 Promise，resolve 后是形如 {topic: "Fitness", modelVersion: "1.2", taxonomyVersion: "202404"} 的对象，topic 字段永远是单一字符串（例如 "HomeImprovement"），不是列表，也不带权重或置信度。
这意味着：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 无法做多主题组合判断（比如“Fitness + Nutrition”联合定向）
- 不能用于人群包构建或后端标签同步——服务端根本收不到这个值
- 如果返回空字符串（
topic === ""），代表当前无可用主题，不要 fallback 到 UA 或 referrer 等替代方案（违反隐私沙盒设计初衷）
典型误用示例：cohort.topic.includes("Travel") 是安全的；但 cohort.topic.split("-") 会报错，因为它是字符串，不是编码串。
Chrome 外的浏览器完全不支持，且标准进程已停滞
截至 2026 年 5 月，navigator.getInterestCohort() 仅在 Chromium 内核浏览器（Chrome、Edge、Brave 等）中存在，Firefox 和 Safari 明确拒绝实现，WebKit 官方已声明“无计划支持”。W3C 未将其纳入标准轨道，WHATWG 也未收录，MDN 标记为 Non-standard 和 Experimental。
实际影响：
- 在 Safari 打开同一页面，
'getInterestCohort' in navigator为false，代码必须有降级逻辑 - 企业内网或 WebView 场景（如 Android WebView、iOS WKWebView）基本不可用，版本碎片严重
- 即使 Chrome 用户开启功能，也受“三周浏览窗口”“每日轮换”“主题粒度粗（共 348 个顶层类目）”等硬限制，无法支撑精细化运营
真要适配兴趣，优先走广告平台 SDK，不是 Topics API
Topics API 的唯一合理用途，是前端轻量语义适配：比如横幅文案从“新品上市”切换为“健身装备推荐”，前提是已有预置的几套文案模板，且不依赖服务端参与。
如果你的真实目标是“向特定兴趣人群精准推送横幅广告”，这条路走不通。可行路径只有：
- 接入腾讯 GDT、穿山甲、华为 Ads Kit 等平台 SDK，在
adParam中传入业务侧打标的人群 ID 或自定义标签（非 Topics） - 用第一方数据（登录态、浏览行为、搜索词）在服务端构建用户画像，再通过广告平台 API 请求定向广告
- 放弃客户端兴趣推断，改用地理围栏、设备类型、页面路径等确定性信号做基础分层
Topics API 的核心约束常被忽略：它不提供稳定 ID、不跨天持久、不保证存在、不支持调试验证——这些恰恰是广告投放最不能妥协的点。
