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 is an interface for loading font faces and checking their download statuses.
Properties
FontFaceSet.statusRead only- Indicates the font face's loading status. It will be one of
'loading'or'loaded'.
Events
FontFaceSet.onloading- An
EventListenerproperty called whenever an event of typeloadingis fired, indicating that a font face set has started to load. FontFaceSet.onloadingdone- An
EventListenerproperty called whenever an event of typeloadingdoneis fired, indicating that a font face set has finished loading. FontFaceSet.onloadingerror- An
EventListenerproperty called whenever an event of typeloadingerroris fired, indicating that an error occurred during the loading of a font face set.
Methods
FontFaceSet.add()- Adds a font to the the font set.
FontFaceSet.check()- A boolean that indicates wether a font is loaded but does not initiate a load when it is not.
FontFaceSet.clear()- Removes all fonts from the font set.
FontFaceSet.delete()- Removes a font from the font set.
FontFaceSet.load()- Returns a
Promiseresolving to a list of font faces for a requested font. FontFaceSet.ready()- Returns a
Promiseindicating that font loading and layout operations are done
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 | Not supported | 35.0 | 41.0 (41) | ? | ? | ? | ? | 35.0 |
| clear() method | Not supported | 48.0 | 48.0 |