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 贡献者修改。