FontFaceSet: load() method
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 load() method of the FontFaceSet forces all the fonts given in parameters to be loaded.
Syntax
load(font)
load(font, text)
Parameters
font-
a font specification using the CSS value syntax, e.g., "italic bold 16px Roboto"
text-
limit the font faces to those whose Unicode range contains at least one of the characters in text. This does not check for individual glyph coverage.
Return value
A Promise fulfilled with an Array of loaded FontFace objects. The
promise is fulfilled when all the fonts are loaded; it is rejected if one of the fonts
failed to load.
Examples
The following example returns a promise that will be fulfilled or rejected according the success of loading "MyFont". The code in then() can assume the availability of that font.
document.fonts.load("12px MyFont", "ß").then(/* ... */);
Specifications
| Specification |
|---|
| CSS Font Loading Module Level 3 # dom-fontfaceset-load |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
load
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support