FontFace: load() method

BaselineWidely 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 inWeb Workers.

Theload() method of theFontFace interface requests and loads a font whosesource was specified as a URL. It returns aPromise that resolves with the currentFontFace object.

If thesource for the font face was specified as binary data, or the fontstatus property of the font face is anything other thanunloaded, then this method does nothing.

Syntax

load()

Parameters

None.

Return value

APromise that resolves with a reference to the currentFontFace object when the font loads or rejects with aNetworkErrorDOMException if the loading process fails.

Exceptions

NetworkErrorDOMException: Indicates that the attempt to load the font failed.

Examples

This simple example loads a font and uses it to display some text in a canvas element (with an id ofjs-canvas).

<canvas></canvas>

const canvas = document.getElementById("js-canvas");// load the "Bitter" font from Google Fontsconst fontFile = new FontFace(  "FontFamily Style Bitter",  "url(https://fonts.gstatic.com/s/bitter/v7/HEpP8tJXlWaYHimsnXgfCOvvDin1pK8aKteLpeZ5c0A.woff2)",);document.fonts.add(fontFile);fontFile.load().then(  () => {    // font loaded successfully!    canvas.width = 650;    canvas.height = 100;    const ctx = canvas.getContext("2d");    ctx.font = '36px "FontFamily Style Bitter"';    ctx.fillText("Bitter font loaded", 20, 50);  },  (err) => {    console.error(err);  },);