+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Constructor
+ + + +new FontFaceObserver(family, descriptors)
+ + + + + + + + + + + + + + +Parameters:
+ + +| Name | + + +Type | + + + + + +Description | +
|---|---|---|
family |
+
+
+ + + +string + + + + | + + + + + +font-family name (required) | +
descriptors |
+
+
+ + + +Descriptors + + + + | + + + + + +an object describing the variation +(optional). The object can contain `weight`, `style`, and `stretch` +properties. If a property is not present it will default to `normal`. | +
Members
+ + + +DEFAULT_TIMEOUT :number
+ + + + + + +Type:
+-
+
- + +number + + + +
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
HAS_SAFARI_10_BUG :null|boolean
+ + + + + + +Type:
+-
+
- + +null +| + +boolean + + + +
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
HAS_WEBKIT_FALLBACK_BUG :null|boolean
+ + + + + + +Type:
+-
+
- + +null +| + +boolean + + + +
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
SUPPORTS_NATIVE_FONT_LOADING :null|boolean
+ + + + + + +Type:
+-
+
- + +null +| + +boolean + + + +
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
SUPPORTS_STRETCH :null|boolean
+ + + + + + +Type:
+-
+
- + +null +| + +boolean + + + +
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Methods
+ + + + + + + +(static) getNavigatorVendor() → {string}
+ + + + + + + + + + + + + + + + + + +-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +string + + + +
(static) getUserAgent() → {string}
+ + + + + + + + + + + + + + + + + + +-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +string + + + +
(static) hasSafari10Bug() → {boolean}
+ + + + + + +
+ Returns true if the browser has the Safari 10 bugs. The native font load
+API in Safari 10 has two bugs that cause the document.fonts.load and
+FontFace.prototype.load methods to return promises that don't reliably get
+settled.
+
+The bugs are described in more detail here:
+ - https://bugs.webkit.org/show_bug.cgi?id=165037
+ - https://bugs.webkit.org/show_bug.cgi?id=164902
+
+If the browser is made by Apple, and has native font loading support, it is
+potentially affected. But the API was fixed around AppleWebKit version 603,
+so any newer versions that that does not contain the bug.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +boolean + + + +
(static) hasWebKitFallbackBug() → {boolean}
+ + + + + + +
+ Returns true if this browser is WebKit and it has the fallback bug which is
+present in WebKit 536.11 and earlier.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +boolean + + + +
(static) supportsNativeFontLoading() → {boolean}
+ + + + + + +
+ Returns true if the browser supports the native font loading API.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +boolean + + + +
(static) supportStretch() → {boolean}
+ + + + + + +
+ Returns true if the browser supports font-style in the font short-hand
+syntax.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +boolean + + + +
load(textopt, timeoutopt) → {Promise.<FontFaceObserver>}
+ + + + + + + + + + + + + + +Parameters:
+ + +| Name | + + +Type | + + +Attributes | + + + + +Description | +
|---|---|---|---|
text |
+
+
+ + + +string + + + + | + + +
+
+ <optional> + + + + + + |
+
+
+
+
+ Optional test string to use for detecting if a font +is available. | +
timeout |
+
+
+ + + +number + + + + | + + +
+
+ <optional> + + + + + + |
+
+
+
+
+ Optional timeout for giving up on font load +detection and rejecting the promise (defaults to 3 seconds). | +
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Source: +
- + + + + + + + +
Returns:
+ + + + +-
+
- + Type + +
- + +Promise.<FontFaceObserver> + + + +
