wait until done

packages/docs/docs/google-fonts/load-font.md

@@ -129,6 +129,23 @@ Unicode range information about the font.
 }
 ```
 
+### `waitUntilDone`<AvailableFrom v="4.0.83"/>
+
+A function that returns a promise that resolves when the font is loaded.
+
+```tsx title="Load a font in the background"
+import { loadFont } from "@remotion/google-fonts/Lobster";
+
+loadFont("normal", {
+  weights: ["400"],
+  subsets: ["latin"],
+})
+  .waitUntilDone()
+  .then(() => {
+    console.log("Done loading");
+  });
+```
+
 ## See also
 
 - [Fonts](/docs/fonts)

packages/google-fonts/src/base.ts

@@ -31,7 +31,9 @@ export const loadFonts = (
   fontFamily: FontInfo["fontFamily"];
   fonts: FontInfo["fonts"];
   unicodeRanges: FontInfo["unicodeRanges"];
+  waitUntilDone: () => Promise<undefined>;
 } => {
+  const promises: Promise<void>[] = [];
   const styles = style ? [style] : Object.keys(meta.fonts);
   for (const style of styles) {
     // Don't load fonts on server
@@ -93,7 +95,7 @@ export const loadFonts = (
         );
 
         //  Load font-face
-        fontFace
+        const promise = fontFace
           .load()
           .then(() => {
             (options?.document ?? document).fonts.add(fontFace);
@@ -104,6 +106,8 @@ export const loadFonts = (
             loadedFonts[fontKey] = false;
             throw err;
           });
+
+        promises.push(promise);
       }
     }
   }
@@ -112,5 +116,6 @@ export const loadFonts = (
     fontFamily: meta.fontFamily,
     fonts: meta.fonts,
     unicodeRanges: meta.unicodeRanges,
+    waitUntilDone: () => Promise.all<void>(promises).then(() => undefined),
   };
 };