This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The FontFaceSet interface of the CSS Font Loading API manages the loading of font-faces and querying of their download status.
Properties
FontFaceSet.statusRead only- Indicates the font-face's loading status. It will be one of
'loading'or'loaded'.
Events
FontFaceSet.onloading- An
EventListenercalled whenever an event of typeloadingis fired, indicating a font-face set has started loading. FontFaceSet.onloadingdone- An
EventListenercalled whenever an event of typeloadingdoneis fired, indicating that a font face set has finished loading. FontFaceSet.onloadingerror- An
EventListenercalled whenever an event of typeloadingerroris fired, indicating that an error occurred whilst loading a font-face set.
Methods
FontFaceSet.add()- Adds a font to the font set.
FontFaceSet.check()- A
Booleanthat indicates whether a font is loaded, but doesn't initiate a load when it isn't. FontFaceSet.clear()- Removes all fonts from the font set.
FontFaceSet.delete()- Removes a font from the font set.
FontFaceSet.load()- Returns a
Promisewhich resolves to a list of font-faces for a requested font. FontFaceSet.ready()- Returns a
Promisewhich resolves once font loading and layout operations have completed.
Specifications
| Specification | Status | Comment |
|---|---|---|
| CSS Font Loading Module Level 3 The definition of 'FontFaceSet' in that specification. |
Working Draft | Initial definition |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 35.0 | 41 (41) | ? | ? | ? |
| clear() method | 48.0 |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
| Basic support | No support | 35.0 | 41.0 (41) | ? | ? | ? | ? | 35.0 |
| clear() method | No support | 48.0 | 48.0 |