UD5工具箱
Content Indexing API相关术语表
Content Indexing API
Content Indexing API是W3C正在标准化的Web API，允许渐进式Web应用（PWA）向浏览器注册其离线可用的内容条目。该API通过Service Worker的registration.index对象暴露，提供add()（添加索引条目）、delete()（删除索引条目）、getAll()（查询所有索引条目）等方法。每个索引条目包含标题、描述、URL、类别、图标等元数据字段。浏览器收到索引注册后，会在用户离线时展示这些内容条目，帮助用户发现和访问离线可用的内容。Content Indexing API的引入填补了PWA在离线内容发现方面的空白，使Web应用在离线场景下也能提供类似原生应用的内容推荐体验。
Progressive Web App（PWA）
渐进式Web应用（PWA）是一种使用Web技术构建的应用形式，具有类似原生应用的用户体验特性。PWA的核心技术包括Service Worker（离线缓存和后台任务）、Web App Manifest（应用安装和启动配置）、HTTPS（安全通信）、以及Content Indexing API等增强API。PWA的特点包括：可离线工作（通过Service Worker缓存关键资源）、可安装到设备主屏幕（通过Web App Manifest）、支持推送通知、自适应屏幕尺寸、通过HTTPS保证安全性。PWA不需要通过应用商店分发，用户通过浏览器访问URL即可使用，降低了分发成本。Content Indexing API是PWA技术栈中的重要组成部分，解决了PWA在离线内容发现方面的技术空白。
Service Worker
Service Worker是PWA的核心技术之一，是一个在浏览器后台运行的JavaScript脚本，独立于网页主线程。Service Worker可以拦截和处理网络请求、管理缓存、执行后台同步、处理推送通知等任务。Service Worker的生命周期包括注册（register）、安装（install）、激活（activate）和运行阶段。在Content Indexing API的上下文中，Service Worker是执行索引操作的唯一场所：只有在Service Worker的上下文中才能访问registration.index对象。在网页的主线程JavaScript中无法直接调用Content Indexing API。Service Worker通过self.registration.index访问内容索引接口，执行add、delete、getAll等操作。Service Worker的后台运行特性使得索引操作不会阻塞用户界面，确保了流畅的用户体验。
索引条目（Index Entry）
索引条目是Content Indexing API中表示单个离线可用内容的数据结构。每个索引条目包含以下核心字段：id是条目的唯一标识符，由API自动生成；title是内容的显示标题，在浏览器的内容推荐界面中作为主要文本显示；description是内容的简短摘要，帮助用户快速了解内容主题；url是内容的访问地址，用户点击条目后导航到该地址；category是内容的分类标签，目前支持article（文章）、video（视频）和other（其他）三种预设类别；icons是内容的图标数组，包含不同尺寸的图标URL，浏览器根据设备屏幕密度选择合适的图标显示。索引条目通过registration.index.add()方法注册到浏览器，浏览器会在离线时向用户展示这些条目。索引条目的元数据直接影响内容在浏览器中的展示效果和用户体验。
内容类别（Content Category）
内容类别是Content Indexing API中用于分类索引条目的标签系统。目前API规范定义了三种预设类别：article（文章）适用于文字型内容资源，如新闻报道、博客文章、教程文档、产品说明等；video（视频）适用于视频型内容资源，如视频教程、产品演示、直播回放、短视频等；other（其他）适用于不属于文章或视频的所有其他类型内容，如工具资源、数据文件、音频内容等。类别标签帮助浏览器在展示离线内容时进行分组和筛选，用户可以按类别查看特定类型的内容。开发者应该根据内容的实际类型选择最合适的类别标签，错误的类别选择可能导致内容在浏览器中的展示不符合用户预期。未来API规范可能会扩展更多的预设类别，以适应更丰富的内容类型需求。
离线可用性（Offline Availability）
离线可用性是指PWA在没有网络连接的情况下仍能提供内容和服务的能力。实现离线可用性需要多个PWA技术协同工作：Service Worker负责缓存网络请求的响应数据，Web App Manifest定义应用的安装和启动行为，Cache API提供缓存存储接口，Content Indexing API则解决了离线内容发现的问题。离线可用性的技术实现分为三个层面：资源级缓存（缓存CSS、JavaScript、图片等静态资源）、页面级缓存（缓存完整的HTML页面）、数据级缓存（缓存API响应和用户数据）。Content Indexing API在离线可用性中扮演的角色是内容发现层：即使内容已经通过Service Worker缓存到本地，如果用户不知道这些内容的存在，离线可用性就失去了意义。内容索引通过向浏览器声明可用的离线内容，使浏览器能够在离线时主动推荐这些内容，完成了离线可用性从技术实现到用户发现的闭环。
Cache API
Cache API是Web平台提供的缓存存储接口，允许JavaScript代码（包括Service Worker）创建和管理请求-响应对的缓存。Cache API与Content Indexing API的区别在于：Cache API负责存储实际的网络请求响应数据（如HTML页面、API响应、图片等），Content Indexing API负责存储内容的元数据信息（如标题、描述、URL等）。Cache API确保内容在离线时可以被访问（数据可用），Content Indexing API确保内容在离线时可以被发现（内容可发现）。两者配合使用才能提供完整的离线内容体验：Cache API缓存内容的实际数据，Content Indexing API向浏览器注册内容的索引信息。Cache API通过caches.open()创建命名缓存，使用cache.put()和cache.match()存储和检索请求-响应对。Cache API的存储容量受浏览器配额限制，过期的缓存条目需要开发者手动或通过Service Worker的清理策略进行管理。
Web App Manifest
Web App Manifest是PWA的配置文件，以JSON格式定义应用的元数据信息。Manifest文件通过HTML中的link标签关联到网页，浏览器在用户安装PWA时读取该文件获取应用信息。Manifest中的关键字段包括：name（应用全名）、short_name（应用短名）、description（应用描述）、start_url（启动URL）、display（显示模式，如standalone独立窗口）、icons（应用图标数组）、background_color和theme_color（主题颜色）。Web App Manifest使PWA能够像原生应用一样被安装到设备主屏幕上，拥有独立的图标和启动画面。Content Indexing API与Web App Manifest的关系在于：Manifest定义了PWA的基本身份信息，Content Indexing API则补充了PWA的离线内容信息。浏览器结合Manifest中的应用信息和Content Indexing API中的内容索引，为用户提供完整的PWA离线体验。
内容可发现性（Content Discoverability）
内容可发现性是指用户能够发现和访问应用中可用内容的容易程度。对于原生应用，操作系统提供了应用内搜索、推荐列表、通知推送等内容发现渠道。对于PWA，内容可发现性一直是技术挑战：用户在离线状态下无法通过网络搜索发现新内容，Service Worker缓存的内容如果没有入口页面的引导也很难被用户主动发现。Content Indexing API的引入有效解决了PWA的离线内容可发现性问题。通过注册内容索引，PWA可以向浏览器声明其离线可用的内容，浏览器在用户离线时会在专门的界面中展示这些内容条目，用户可以像浏览原生应用的内容列表一样发现和访问离线内容。内容可发现性对于内容密集型PWA（如新闻网站、博客平台、播客应用）尤为重要，直接影响用户的回访率和内容消费量。良好的内容可发现性设计是PWA成功的关键因素之一。