值
返回值是该文档的 FontFaceSet 接口。FontFaceSet 接口可用于加载新字体、检查先前已加载字体的状态等。
示例
在字体加载完成后执行操作
js
document.fonts.ready.then((fontFaceSet) => {
// 任何需要在所有已用字体加载完成后才执行的操作都可以放在这里。
const fontFaces = [...fontFaceSet];
console.log(fontFaces);
// 若站点未使用某些字体，它们可能仍处于未加载状态
console.log(fontFaces.map((f) => f.status));
});
当所有已用字体的加载和布局操作完成后，该 Promise 会兑现。已用字体集合可能与已声明字体集合不同，例如可选字体（即通过 font-display: optional 声明的字体）未能及时加载时。
规范
| 规范 |
|---|
| CSS Font Loading Module Level 3 # FontFaceSet-interface |