FontFaceSet：loadingerror 事件

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起，所有主流瀏覽器均已支援。

注意：此功能在 Web Workers 中可用。

當字型載入完成，但部分或全部字型載入失敗時，會觸發 loadingerror 事件。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱，或設定事件處理程式屬性。

addEventListener("loadingerror", (event) => { })

onloadingerror = (event) => { }

在下面的示例中，如果字型 Ephesis 載入失敗，則會在控制檯列印“Font loading error”（字型載入錯誤）。

document.fonts.onloadingerror = () => {
  console.log("Font loading error");
};

(async () => {
  await document.fonts.load("16px Ephesis");
})();

規範
CSS 字型載入模組等級 3 # dom-fontfaceset-onloadingerror

此頁面最後修改於 ⁨2025 年 5 月 2 日⁩，由 MDN 貢獻者修改。