W3cubDocs

/Web APIs

FontFaceSet: loadingerror event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨January 2020⁩.

Note: This feature is available in Web Workers.

The loadingerror event fires when fonts have finished loading, but some or all fonts have failed to load.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

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

onloadingerror = (event) => { }

Example

In the following example, if the font Ephesis fails to load, "Font loading error" is printed to the console.

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

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

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
loadingerror_event 35 79 41 22 10 35 41 22 10 3.0 37 10

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FontFaceSet/loadingerror_event