FontFaceSet.load()

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use 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 spec changes.

The load() method of the FontFaceSet forces all the fonts given in parameters to be loaded.

Syntax

JavaScript
<var>result</var> = <var>aFontFaceSet</var>.load(font);

result = aFontFaceSet.load(font, text);

Returns

A Promise of an Array of FontFace loaded. The promise is fulfilled when all the fonts are loaded; it is rejected if one of the fonts failed to load.

Parameters

Examples

JavaScript
// returns a promise that will be fulfilled or rejected according the success to load MyFont
// The code in 'then' can assume the availability of that font.

document.fonts.load("12px MyFont", "ß").then(…);  

Specifications

Specification Status Comment
CSS Font Loading Module Level 3
The definition of 'load' in that specification.
Working Draft Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 35.0 41 (41) ? ? ?
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

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/fontfaceset/load

API CSS Font Loading API Experimental FontFaceSet Method Reference