snapshot of https://github.com/jitsi/jitsi-meet.git @ fd1749dd28f4138aa80234fc7f311b19aaffa0e7 (2026-09-15)

react/features/base/participants/preloadImage.web.ts

@@ -0,0 +1,64 @@
+
+import { isIconUrl } from './functions';
+
+/**
+ * Tries to preload an image.
+ *
+ * @param {string | Object} src - Source of the avatar.
+ * @param {boolean} useCORS - Whether to use CORS or not.
+ * @param {boolean} tryOnce - If true we try to load the image only using the specified CORS mode. Otherwise both modes
+ * (CORS and no CORS) will be used to load the image if the first attempt fails.
+ * @returns {Promise}
+ */
+export function preloadImage(
+        src: string,
+        useCORS = false,
+        tryOnce = false
+): Promise<{ isUsingCORS?: boolean; src: string | Object; }> {
+    if (isIconUrl(src)) {
+        return Promise.resolve({ src });
+    }
+
+    return new Promise((resolve, reject) => {
+        const image = document.createElement('img');
+
+        // Cleanup function to release resources and prevent memory leaks
+        const cleanup = () => {
+            // Clear event handlers to break circular references
+            image.onload = null;
+            image.onerror = null;
+
+            // Clear src to stop any pending load and allow GC
+            image.src = '';
+        };
+
+        if (useCORS) {
+            image.setAttribute('crossOrigin', '');
+        }
+
+        image.onload = () => {
+            cleanup();
+            resolve({
+                src,
+                isUsingCORS: useCORS
+            });
+        };
+
+        image.onerror = error => {
+            cleanup();
+
+            if (tryOnce) {
+                reject(error);
+            } else {
+                // Retry with different CORS mode
+                preloadImage(src, !useCORS, true)
+                    .then(resolve)
+                    .catch(reject);
+            }
+        };
+
+        image.referrerPolicy = 'no-referrer';
+
+        image.src = src;
+    });
+}