功能状态

功能状态大致表示某个 Web 平台功能（例如 Web API 方法或 CSS 属性）的跨浏览器实现和标准化状态。

它是以下状态之一：

警告：请勿手动更新 mdn/content 存储库中的功能状态。文档源是从 GitHub mdn/browser-compat-data 存储库中的信息自动更新的。

如果不适用以上任何状态，则该功能被视为稳定且标准的功能。有关这些术语的更多信息，请参阅 “实验性、已弃用和已废弃”页面。

有关如何确定功能状态的信息，请参阅 @mdn/browser-compat-data (BCD) 存储库中选择状态属性部分。

如何添加或更新功能状态？

MDN 上记录的所有功能的特征状态都跟踪在其配套的 @mdn/browser-compat-data (BCD) 存储库中。每当发布新版本的 BCD 时，都会通过自动化自动更新 mdn/content 存储库中的状态。

自动化使用前端的 browser-compat 键。该键存储用于在兼容性数据中定位功能的 BCD 查询。如果 browser-compat 键有多个值，则自动化仅使用第一个值来渲染状态宏。

注意：要更新 MDN 内容中的功能状态，您需要向 BCD 存储库提交拉取请求。在您的更改在 BCD 中获得批准并合并后，它将进入每周发布，并且自动化拉取请求将在每次发布时更新 mdn/content 存储库中的状态。

以下部分记录了用于在 MDN 文档中插入和渲染功能状态信息的机制。如前所述，这些应被视为只读，因为它们在内容中的包含是自动化的。

页面前端的 status 属性用于生成显示在侧边栏中的功能的 istatus 图标。

yaml

---
title: Feature name
status:
  - deprecated
  - experimental
  - non-standard
browser-compat: api.feature
---

以下宏用于在页面标题中渲染状态横幅：

{{Deprecated_Header}}: 用于 deprecated 状态。它会生成一个已弃用状态横幅。
已弃用：此特性不再推荐。虽然某些浏览器可能仍然支持它，但它可能已经从相关的网络标准中删除，可能正在删除过程中，或者可能仅为兼容性目的而保留。请避免使用它，如果可能，请更新现有代码；请参阅本页底部的兼容性表格以指导您的决策。请注意，此特性可能随时停止工作。
{{SeeCompatTable}}: 用于 experimental 状态。它会生成一个实验性状态横幅。
实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。
{{Non-standard_Header}}: 用于 non-standard 状态。它会生成一个非标准状态横幅。
非标准：此特性未标准化。我们不建议在生产环境中使用非标准特性，因为它们浏览器支持有限，并且可能会更改或被移除。但是，在没有标准选项的特定情况下，它们可以是合适的替代方案。

以下宏用于在定义列表项旁边渲染内嵌状态图标：

如果 Web 功能页面具有状态横幅，则在定义列表中对功能的每个成员/值显式使用相同状态的内嵌宏。例如，如果页面使用 {{SeeCompatTable}} 标记为实验性，则功能的每个成员/值都使用定义列表中的 {{Experimental_Inline}} 宏显式标记为实验性。

此页面最后修改于 2025 年 9 月 19 日，作者是 MDN 贡献者。