FontFaceSet: add() 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 add() method of the FontFaceSet interface adds a new font to the set.

Syntax

js
add(font)

Parameters

font

A FontFace to be added to the set.

Return value

A new FontFaceSet.

Exceptions

InvalidModificationError DOMException

Thrown if this font is already included via the CSS @font-face rule.

Examples

In the following example a new FontFace object is created and then added to the FontFaceSet.

js
const font = new FontFace("MyFont", "url(myFont.woff2)");
document.fonts.add(font);

Specifications

Specification
CSS Font Loading Module Level 3
# dom-fontfaceset-add

Browser compatibility