FontFaceSet: add() method

{{APIRef("CSS Font Loading API")}}{{AvailableInWorkers}}

The add() method of the {{domxref("FontFaceSet")}} interface adds a new font to the set.

Syntax

add(font)

Parameters

• font
  • : A {{domxref("FontFace")}} to be added to the set.

Return value

A new {{domxref("FontFaceSet")}}.

Exceptions

• InvalidModificationError {{domxref("DOMException")}}
  • : Thrown if this font is already included via the CSS {{cssxref("@font-face")}} rule.

Examples

In the following example a new {{domxref("FontFace")}} object is created and then added to the {{domxref("FontFaceSet")}}.

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}