MDN self-hosted library · e01.org

FontFaceSet

CSS Font Loading API

no runnable cells web-api-interface upstream source

CSS Font Loading API

The FontFaceSet interface of the CSS Font Loading API manages the loading of font-faces and querying of their download status.

A FontFaceSet instance is a Set-like object that can hold an ordered set of FontFace objects.

This property is available as Document.fonts, or self.fonts in web workers.

Instance properties

  • FontFaceSet.status
  • : Indicates the font-face's loading status. It will be one of 'loading' or 'loaded'.
  • FontFaceSet.ready
  • : Promise which resolves once font loading and layout operations have completed.
  • FontFaceSet.size
  • : Returns the number of values in the FontFaceSet.

Instance methods

  • FontFaceSet.add()
  • : Adds a font to the font set.
  • FontFaceSet.check()
  • : A boolean value that indicates whether a font is loaded, but doesn't initiate a load when it isn't.
  • FontFaceSet.clear()
  • : Removes all manually-added fonts from the font set. CSS-connected fonts are unaffected.
  • FontFaceSet.delete()
  • : Removes a manually-added font from the font set. CSS-connected fonts are unaffected.
  • FontFaceSet.entries()
  • : Returns a new iterator with the values for each element in the FontFaceSet in insertion order.
  • FontFaceSet.forEach()
  • : Executes a provided function for each value in the FontFaceSet object.
  • FontFaceSet.has()
  • : Returns a Boolean asserting whether an element is present with the given value.
  • FontFaceSet.keys()
  • : An alias for FontFaceSet.values().
  • FontFaceSet.load()
  • : Returns a Promise which resolves to a list of font-faces for a requested font.
  • FontFaceSet.values()
  • : Returns a new iterator object that yields the values for each element in the FontFaceSet object in insertion order.

Events

  • loading
  • : Fires when a font-face set has started loading.
  • loadingdone
  • : Fires when a font face set has finished loading.
  • loadingerror
  • : Fires when an error occurred while loading a font-face set.

Specifications

Browser compatibility