功能狀態

功能狀態大致表示某個 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 貢獻者。