@lynker-desktop/electron-window-manager 0.0.9-alpha.2 → 0.0.9-alpha.20

package/main/index.js

@@ -69,30 +69,43 @@ class WindowsManager {
      *   - 不带点的（如 example.com）只匹配主域名。
      *   - 'localhost'、'127.0.0.1'、'::1' 以及局域网 IP（如 192.168.x.x、10.x.x.x、172.16.x.x~172.31.x.x）都视为本地白名单。
      */
-    constructor(preload, loadingViewUrl, errorViewUrl, preloadWebContentsUrl, webviewDomainWhiteList) {
+    constructor(preload, loadingViewUrl, errorViewUrl, preloadWebContentsConfig, webviewDomainWhiteList) {
+        // 预加载的窗口
         this.preloadedBW = null;
+        // 预加载的窗口（无边框，有按钮）
         this.preloadedBW_FramelessWithButtons = null;
+        // 预加载的窗口（无边框，无按钮）
         this.preloadedBW_FramelessNoButtons = null;
+        // 预加载的浏览器视图
         this.preloadedBV = null;
         this.preloading = false;
         this.webviewDomainWhiteList = [];
+        // 创建队列相关属性
+        this.createQueue = [];
+        this.isCreating = false;
         this.preload = preload;
         this.windows = new Map();
         this.loadingViewUrl = `${loadingViewUrl ?? ''}`;
         this.errorViewUrl = `${errorViewUrl ?? ''}`;
-        this.preloadWebContentsUrl = `${preloadWebContentsUrl ?? ''}`;
+        this.preloadWebContentsConfig = preloadWebContentsConfig;
         this.webviewDomainWhiteList = webviewDomainWhiteList || [];
-        log('log', 'preloadWebContentsUrl: ', this.preloadWebContentsUrl);
-        if (this.preloadWebContentsUrl) {
-            electron.app.on('ready', () => {
-                this._preloadInstances();
+        log('log', 'preloadWebContentsConfig: ', this.preloadWebContentsConfig);
+        if (this.preloadWebContentsConfig) {
+            electron.app.whenReady().then(() => {
+                if (this.preloadWebContentsConfig) {
+                    this.setPreloadWebContentsConfig(this.preloadWebContentsConfig);
+                }
             });
         }
     }
-    setPreloadWebContentsUrl(preloadWebContentsUrl) {
+    /**
+     * 设置预加载的webContents配置
+     * @param preloadWebContentsConfig 预加载的webContents配置
+     */
+    setPreloadWebContentsConfig(preloadWebContentsConfig) {
         try {
-            this.preloadWebContentsUrl = preloadWebContentsUrl;
-            if (this.preloadWebContentsUrl) {
+            this.preloadWebContentsConfig = preloadWebContentsConfig;
+            if (this.preloadWebContentsConfig) {
                 this._preloadInstances();
             }
             else {
@@ -103,27 +116,65 @@ class WindowsManager {
             }
         }
         catch (error) {
-            log('error', 'setPreloadWebContentsUrl error:', error);
+            log('error', 'setPreloadWebContentsConfig error:', error);
         }
     }
+    /**
+     * 预加载实例
+     */
     async _preloadInstances() {
         if (this.preloading)
             return;
         this.preloading = true;
         try {
-            if (this.preloadWebContentsUrl) {
-                this.preloadedBW = this.preloadedBW || await this._createPreloadBW({});
-                this.preloadedBW_FramelessWithButtons = this.preloadedBW_FramelessWithButtons || await this._createPreloadBW({
-                    frame: false,
-                    transparent: true,
-                    titleBarStyle: 'hidden',
-                });
-                this.preloadedBW_FramelessNoButtons = this.preloadedBW_FramelessNoButtons || await this._createPreloadBW({
-                    frame: false,
-                    transparent: true,
-                    titleBarStyle: 'customButtonsOnHover',
-                });
-                this.preloadedBV = this.preloadedBV || await this._createPreloadBV();
+            if (this.preloadWebContentsConfig) {
+                log('log', 'preloadWebContentsConfig: ', this.preloadWebContentsConfig);
+                // 根据配置决定是否预加载普通窗口
+                if (this.preloadWebContentsConfig.enableBW !== false) {
+                    if (!this.preloadedBW) {
+                        this._createPreloadBW({}).then(i => {
+                            this.preloadedBW = i;
+                            log('log', 'init preloadedBW: ', !!this.preloadedBW);
+                        });
+                    }
+                }
+                // 根据配置决定是否预加载无边框有按钮的窗口
+                if (this.preloadWebContentsConfig.enableBW_FramelessWithButtons !== false) {
+                    if (!this.preloadedBW_FramelessWithButtons) {
+                        this._createPreloadBW({
+                            frame: false,
+                            // transparent: true,
+                            autoHideMenuBar: true,
+                            titleBarStyle: 'hidden',
+                        }).then(i => {
+                            this.preloadedBW_FramelessWithButtons = i;
+                            log('log', 'init preloadedBW_FramelessWithButtons: ', !!this.preloadedBW_FramelessWithButtons);
+                        });
+                    }
+                }
+                // 根据配置决定是否预加载无边框无按钮的窗口
+                if (this.preloadWebContentsConfig.enableBW_FramelessNoButtons !== false) {
+                    if (!this.preloadedBW_FramelessNoButtons) {
+                        this._createPreloadBW({
+                            frame: false,
+                            // transparent: true,
+                            autoHideMenuBar: true,
+                            titleBarStyle: 'default',
+                        }).then(i => {
+                            this.preloadedBW_FramelessNoButtons = i;
+                            log('log', 'init preloadedBW_FramelessNoButtons: ', !!this.preloadedBW_FramelessNoButtons);
+                        });
+                    }
+                }
+                // 根据配置决定是否预加载浏览器视图
+                if (this.preloadWebContentsConfig.enableBV !== false) {
+                    if (!this.preloadedBV) {
+                        this._createPreloadBV().then(i => {
+                            this.preloadedBV = i;
+                            log('log', 'init preloadedBV: ', !!this.preloadedBV);
+                        });
+                    }
+                }
             }
         }
         catch (e) {
@@ -131,23 +182,30 @@ class WindowsManager {
         }
         this.preloading = false;
     }
+    /**
+     * 创建预加载的窗口
+     * @param options 窗口选项
+     * @returns 预加载的窗口
+     */
     _createPreloadBW(options = {}) {
         return new Promise((resolve) => {
             const preload = this.preload;
-            const url = this.preloadWebContentsUrl;
-            if (this.preloadWebContentsUrl) {
+            const url = this.preloadWebContentsConfig?.url;
+            if (this.preloadWebContentsConfig?.url) {
+                const webPreferences = (options.webPreferences || {});
                 const instance = new electron.BrowserWindow({
                     show: false,
+                    backgroundColor: '#ffffff',
                     ...options,
                     webPreferences: {
+                        ...webPreferences,
                         webviewTag: true,
                         plugins: true,
                         nodeIntegration: true,
                         contextIsolation: false,
                         backgroundThrottling: false,
                         webSecurity: false,
-                        preload: preload,
-                        ...(options.webPreferences || {}),
+                        preload: webPreferences.preload || preload,
                     }
                 });
                 try {
@@ -164,31 +222,41 @@ class WindowsManager {
                     log('error', '预加载 BW 设置 _id 失败', error);
                 }
                 // @ts-ignore
-                log('log', '创建预BW: ', instance._id, this.preloadWebContentsUrl);
-                instance.webContents.once('did-finish-load', () => {
-                    resolve(instance);
-                });
-                instance.webContents.once('did-fail-load', () => {
-                    resolve(instance);
-                });
-                instance.loadURL(url || 'about:blank');
+                log('log', '创建预BW: ', instance._id, this.preloadWebContentsConfig?.url);
+                // instance.webContents.once('did-finish-load', () => {
+                //   resolve(instance as BWItem);
+                // });
+                // instance.webContents.once('did-fail-load', () => {
+                //   resolve(instance as BWItem);
+                // });
+                instance.loadURL(url ? `${url}` : 'about:blank');
+                resolve(instance);
+            }
+            else {
+                resolve(null);
             }
         });
     }
-    _createPreloadBV() {
+    /**
+     * 创建预加载的浏览器视图
+     * @returns 预加载的浏览器视图
+     */
+    _createPreloadBV(options = {}) {
         return new Promise((resolve) => {
             const preload = this.preload;
-            const url = this.preloadWebContentsUrl;
-            if (this.preloadWebContentsUrl) {
+            const url = this.preloadWebContentsConfig?.url;
+            if (this.preloadWebContentsConfig?.url) {
+                const webPreferences = (options.webPreferences || {});
                 const instance = new electron.BrowserView({
                     webPreferences: {
+                        ...webPreferences,
                         webviewTag: true,
                         plugins: true,
                         nodeIntegration: true,
                         contextIsolation: false,
                         // backgroundThrottling: false,
                         webSecurity: false,
-                        preload: preload,
+                        preload: webPreferences.preload || preload,
                     }
                 });
                 try {
@@ -205,56 +273,123 @@ class WindowsManager {
                     log('error', '预加载 BV 设置 _id 失败', error);
                 }
                 // @ts-ignore
-                log('log', '创建预BV: ', instance._id, this.preloadWebContentsUrl);
-                instance.webContents.once('did-finish-load', () => {
-                    resolve(instance);
-                });
-                instance.webContents.once('did-fail-load', () => {
-                    resolve(instance);
-                });
+                log('log', '创建预BV: ', instance._id, this.preloadWebContentsConfig?.url);
+                // instance.webContents.once('did-finish-load', () => {
+                //   resolve(instance as BVItem);
+                // });
+                // instance.webContents.once('did-fail-load', () => {
+                //   resolve(instance as BVItem);
+                // });
                 instance.webContents.loadURL(url || 'about:blank');
+                resolve(instance);
+            }
+            else {
+                resolve(null);
             }
         });
     }
     create(options) {
+        return new Promise((resolve, reject) => {
+            // 将创建请求添加到队列
+            this.createQueue.push({ options, resolve, reject });
+            // 如果当前没有在创建，则开始处理队列
+            if (!this.isCreating) {
+                this.processCreateQueue();
+            }
+        });
+    }
+    /**
+     * 处理创建队列
+     */
+    async processCreateQueue() {
+        if (this.isCreating || this.createQueue.length === 0) {
+            return;
+        }
+        this.isCreating = true;
+        while (this.createQueue.length > 0) {
+            const { options, resolve, reject } = this.createQueue.shift();
+            try {
+                const window = await this._createWindow(options);
+                resolve(window);
+            }
+            catch (error) {
+                log('error', 'create window failed:', error);
+                reject(error);
+            }
+        }
+        this.isCreating = false;
+    }
+    /**
+     * 实际的窗口创建逻辑
+     */
+    async _createWindow(options) {
         let window;
         const { usePreload = true, type = 'BW', name = 'anonymous', url, loadingView = { url: undefined }, errorView = { url: undefined }, browserWindow: browserWindowOptions, openDevTools = false, preventOriginClose = false, } = options;
         options.type = type;
         // 优先复用预创建实例
         let preloadWin = null;
-        if (type === 'BW' && usePreload && this.preloadWebContentsUrl) {
+        if (type === 'BW' && usePreload && this.preloadWebContentsConfig?.url) {
             const bwOptions = browserWindowOptions || {};
-            if (bwOptions.frame === false && bwOptions.titleBarStyle === 'hidden') {
-                preloadWin = this.preloadedBW_FramelessWithButtons;
-                this.preloadedBW_FramelessWithButtons = null;
-                setTimeout(() => this._createPreloadBW({ frame: false, transparent: true, titleBarStyle: 'hidden' }), 0);
-            }
-            else if (bwOptions.frame === false && bwOptions.titleBarStyle === 'customButtonsOnHover') {
-                preloadWin = this.preloadedBW_FramelessNoButtons;
-                this.preloadedBW_FramelessNoButtons = null;
-                setTimeout(() => this._createPreloadBW({ frame: false, transparent: true, titleBarStyle: 'customButtonsOnHover' }), 0);
+            if (bwOptions.frame === false) {
+                if (bwOptions.titleBarStyle === 'default' || !bwOptions.titleBarStyle) {
+                    if (this.preloadWebContentsConfig.enableBW_FramelessNoButtons !== false && this.preloadedBW_FramelessNoButtons) {
+                        preloadWin = this.preloadedBW_FramelessNoButtons;
+                        this.preloadedBW_FramelessNoButtons = await this._createPreloadBW({
+                            frame: false,
+                            // transparent: true,
+                            titleBarStyle: 'default',
+                            webPreferences: {
+                                preload: bwOptions?.webPreferences?.preload || this.preload,
+                            }
+                        });
+                    }
+                }
+                else {
+                    if (this.preloadWebContentsConfig.enableBW_FramelessWithButtons !== false && this.preloadedBW_FramelessWithButtons) {
+                        preloadWin = this.preloadedBW_FramelessWithButtons;
+                        this.preloadedBW_FramelessWithButtons = await this._createPreloadBW({
+                            frame: false,
+                            // transparent: true,
+                            titleBarStyle: 'hidden',
+                            webPreferences: {
+                                preload: this.preload,
+                            }
+                        });
+                    }
+                }
             }
             else {
-                preloadWin = this.preloadedBW;
-                this.preloadedBW = null;
-                setTimeout(() => this._createPreloadBW({}), 0);
+                if (this.preloadWebContentsConfig.enableBW !== false && this.preloadedBW) {
+                    preloadWin = this.preloadedBW;
+                    this.preloadedBW = await this._createPreloadBW({
+                        webPreferences: {
+                            preload: bwOptions?.webPreferences?.preload || this.preload,
+                        }
+                    });
+                }
             }
         }
-        if (type === 'BV' && usePreload && this.preloadWebContentsUrl) {
-            preloadWin = this.preloadedBV;
-            this.preloadedBV = null;
-            setTimeout(() => this._createPreloadBV(), 0);
+        if (type === 'BV' && usePreload && this.preloadWebContentsConfig?.url) {
+            const bvOptions = browserWindowOptions || {};
+            if (this.preloadWebContentsConfig.enableBV !== false && this.preloadedBV) {
+                preloadWin = this.preloadedBV;
+                this.preloadedBV = await this._createPreloadBV({
+                    webPreferences: {
+                        preload: bvOptions?.webPreferences?.preload || this.preload,
+                    }
+                });
+            }
         }
         if (preloadWin) {
             const win = preloadWin;
-            log('log', `${name} 使用预加载窗口`, win._id);
+            log('log', `${name} 使用预加载窗口(${type})`, win._id);
             win._type = 'BW';
             win._name = options.name || 'anonymous';
             win._extraData = `${options?.extraData || ''}`;
             win._initUrl = `${options?.url || ''}`;
             // @ts-ignore
-            win?.removeAllListeners && win?.removeAllListeners?.();
-            win.webContents.removeAllListeners && win.webContents.removeAllListeners();
+            // win?.removeAllListeners && win?.removeAllListeners?.();
+            // win.webContents.removeAllListeners && win.webContents.removeAllListeners();
             if (type === 'BW') {
                 // @ts-ignore
                 this._applyBrowserWindowOptions(win, options);
@@ -262,27 +397,79 @@ class WindowsManager {
             if (type === 'BV') {
                 this._applyBrowserViewOptions(win, options);
             }
+            if (typeof this.preloadWebContentsConfig?.customLoadURL === 'function') {
+                try {
+                    if (type === 'BW') {
+                        // @ts-ignore
+                        const originLoadURL = win.loadURL;
+                        // @ts-ignore
+                        win.loadURL = async (url) => {
+                            return new Promise(async (resolve, reject) => {
+                                try {
+                                    console.error('customLoadURL win.loadURL');
+                                    // @ts-ignore
+                                    await this.preloadWebContentsConfig.customLoadURL(url || 'about:blank', (url) => originLoadURL.call(win, url), win.webContents);
+                                    try {
+                                        win.emit('ready-to-show');
+                                    }
+                                    catch (error) {
+                                        log('error', 'emit ready-to-show event failed:', error);
+                                    }
+                                    resolve(undefined);
+                                }
+                                catch (error) {
+                                    reject(error);
+                                }
+                            });
+                        };
+                    }
+                    const originWebContentsLoadURL = win.webContents.loadURL;
+                    // @ts-ignore
+                    win.webContents.loadURL = async (url) => {
+                        return new Promise(async (resolve, reject) => {
+                            try {
+                                console.error('customLoadURL win.webContents.loadURL');
+                                // @ts-ignore
+                                await this.preloadWebContentsConfig.customLoadURL(url || 'about:blank', (url) => originWebContentsLoadURL.call(win.webContents, url), win.webContents);
+                                try {
+                                    win.webContents.emit('ready-to-show');
+                                }
+                                catch (error) {
+                                    log('error', 'emit ready-to-show event failed:', error);
+                                }
+                                resolve(undefined);
+                            }
+                            catch (error) {
+                                reject(error);
+                            }
+                        });
+                    };
+                }
+                catch (error) {
+                    console.error('customLoadURL error', error);
+                }
+            }
             window = win;
         }
         try {
-            try {
-                loadingView.url = `${loadingView?.url ?? this.loadingViewUrl}`;
-                lodash.merge(options, {
-                    loadingView,
-                });
-            }
-            catch (error) {
-                log('error', 'loadingView error:', loadingView, this.loadingViewUrl);
-            }
-            try {
-                errorView.url = `${errorView?.url ?? this.errorViewUrl}`;
-                lodash.merge(options, {
-                    errorView,
-                });
-            }
-            catch (error) {
-                log('error', 'errorView error:', errorView, this.errorViewUrl);
-            }
+            loadingView.url = `${loadingView?.url ?? this.loadingViewUrl}`;
+            lodash.merge(options, {
+                loadingView,
+            });
+        }
+        catch (error) {
+            log('error', 'loadingView error:', loadingView, this.loadingViewUrl);
+        }
+        try {
+            errorView.url = `${errorView?.url ?? this.errorViewUrl}`;
+            lodash.merge(options, {
+                errorView,
+            });
+        }
+        catch (error) {
+            log('error', 'errorView error:', errorView, this.errorViewUrl);
+        }
+        try {
             let parentWin = undefined;
             if (typeof browserWindowOptions?.parent === 'number') {
                 parentWin = electron.BrowserWindow.fromId(browserWindowOptions?.parent) || undefined;
@@ -336,6 +523,8 @@ class WindowsManager {
                     log('error', 'enable: ', error);
                 }
             }
+            // 停止加载
+            // window.webContents?.stop?.();
             // @ts-ignore
             try {
                 window.id = Number(`${window.id || window.webContents.id}`);
@@ -364,7 +553,7 @@ class WindowsManager {
             if (errorView?.url) {
                 if (type === 'BW') {
                     const showErrorView = lodash.debounce(() => {
-                        const _url = window?.webContents?.getURL?.() || url;
+                        const _url = window._initUrl;
                         /**
                          * 判断是否是错误视图
                          */
@@ -378,16 +567,37 @@ class WindowsManager {
                 sessionStorage.setItem(key, "${_url}");
               `);
                         }
-                    }, 300);
+                    }, 1000);
                     // @ts-ignore
                     window.webContents.on('did-fail-load', (event, errorCode, errorDescription, validatedURL, isMainFrame) => {
                         if (isMainFrame) {
                             showErrorView();
                         }
                     });
+                    // 当开始加载时取消错误视图
                     window.webContents.on('did-start-loading', () => {
                         showErrorView.cancel();
                     });
+                    // 当导航开始时取消错误视图
+                    window.webContents.on('did-start-navigation', () => {
+                        showErrorView.cancel();
+                    });
+                    // 当页面重新加载时取消错误视图
+                    window.webContents.on('did-navigate', () => {
+                        showErrorView.cancel();
+                    });
+                    // 当页面完成加载时取消错误视图
+                    window.webContents.on('did-finish-load', () => {
+                        showErrorView.cancel();
+                    });
+                    // 当窗口关闭时取消错误视图
+                    window.webContents.on('close', () => {
+                        showErrorView.cancel();
+                    });
+                    // 当窗口销毁时取消错误视图
+                    window.webContents.on('destroyed', () => {
+                        showErrorView.cancel();
+                    });
                 }
             }
             window.webContents.on('did-attach-webview', (_event, webContents) => {
@@ -469,10 +679,6 @@ class WindowsManager {
                 parentWin?.addBrowserView(window);
                 log('log', 'create - addBrowserView');
             }
-            // @ts-ignore
-            window.loadURL ? window.loadURL(options.url) : window.webContents.loadURL(options.url);
-            // @ts-ignore
-            window.focus ? window.focus() : window.webContents.focus();
             this.windows.set(window.id || window._id || window.webContents.id, window);
             log('log', 'create', this.windows.keys());
             // 初始化值
@@ -565,6 +771,12 @@ class WindowsManager {
                     log('error', 'focus', error);
                 }
             }
+            if (options.url) {
+                // @ts-ignore
+                window.loadURL ? window.loadURL(options.url) : window.webContents.loadURL(options.url);
+                // @ts-ignore
+                window.focus ? window.focus() : window.webContents.focus();
+            }
         }
         catch (error) {
             log('error', 'create', error);
@@ -828,6 +1040,86 @@ class WindowsManager {
         if (typeof browserWindowOptions.alwaysOnTop === 'boolean') {
             win.setAlwaysOnTop(browserWindowOptions.alwaysOnTop);
         }
+        // 设置背景颜色
+        if (typeof browserWindowOptions.backgroundColor === 'string') {
+            win.setBackgroundColor(browserWindowOptions.backgroundColor);
+        }
+        // 居中
+        if (browserWindowOptions?.center !== false) {
+            win.center();
+        }
+        // 设置窗口移动
+        if (typeof browserWindowOptions.movable === 'boolean') {
+            win.setMovable(browserWindowOptions.movable);
+        }
+        // 设置窗口大小调整
+        if (typeof browserWindowOptions.resizable === 'boolean') {
+            win.setResizable(browserWindowOptions.resizable);
+        }
+        // 设置全屏模式
+        if (typeof browserWindowOptions.fullscreenable === 'boolean') {
+            win.setFullScreenable(browserWindowOptions.fullscreenable);
+        }
+        // 设置窗口阴影
+        if (typeof browserWindowOptions.hasShadow === 'boolean') {
+            win.setHasShadow(browserWindowOptions.hasShadow);
+        }
+        // 设置窗口最小尺寸
+        if (typeof browserWindowOptions.minWidth === 'number' && typeof browserWindowOptions.minHeight === 'number') {
+            win.setMinimumSize(browserWindowOptions.minWidth, browserWindowOptions.minHeight);
+        }
+        // 设置窗口最大尺寸
+        if (typeof browserWindowOptions.maxWidth === 'number' && typeof browserWindowOptions.maxHeight === 'number') {
+            win.setMaximumSize(browserWindowOptions.maxWidth, browserWindowOptions.maxHeight);
+        }
+        // 设置窗口位置
+        if (typeof browserWindowOptions.x === 'number' && typeof browserWindowOptions.y === 'number') {
+            win.setPosition(browserWindowOptions.x, browserWindowOptions.y);
+        }
+        // 设置窗口标题
+        if (typeof browserWindowOptions.title === 'string') {
+            win.setTitle(browserWindowOptions.title);
+        }
+        // 设置窗口图标
+        if (typeof browserWindowOptions.icon === 'string') {
+            win.setIcon(browserWindowOptions.icon);
+        }
+        // 设置窗口菜单栏可见性
+        if (typeof browserWindowOptions.autoHideMenuBar === 'boolean') {
+            win.setAutoHideMenuBar(browserWindowOptions.autoHideMenuBar);
+        }
+        // 设置窗口最小化按钮
+        if (browserWindowOptions.minimizable === false) {
+            win.setMinimizable(false);
+        }
+        // 设置窗口最大化按钮
+        if (browserWindowOptions.maximizable === false) {
+            win.setMaximizable(false);
+        }
+        // 设置窗口关闭按钮
+        if (browserWindowOptions.closable === false) {
+            win.setClosable(false);
+        }
+        // 设置窗口焦点
+        if (browserWindowOptions.focusable === false) {
+            win.setFocusable(false);
+        }
+        // 设置窗口全屏
+        if (browserWindowOptions.fullscreen === true) {
+            win.setFullScreen(true);
+        }
+        // 设置窗口背景材质
+        if (typeof browserWindowOptions.vibrancy === 'string') {
+            win.setVibrancy(browserWindowOptions.vibrancy);
+        }
+        // 设置窗口透明度
+        if (typeof browserWindowOptions.opacity === 'number') {
+            win.setOpacity(browserWindowOptions.opacity);
+        }
+        // 设置窗口显示状态
+        if (browserWindowOptions.show === false) {
+            win.hide();
+        }
         // 可继续扩展其他动态属性
     }
     _applyBrowserViewOptions(view, options) {
@@ -843,12 +1135,26 @@ class WindowsManager {
         if (typeof browserWindowOptions.width === 'number' && typeof browserWindowOptions.height === 'number') {
             view.setBounds({ x: 0, y: 0, width: browserWindowOptions.width, height: browserWindowOptions.height });
         }
+        // 设置视图位置
+        if (typeof browserWindowOptions.x === 'number' && typeof browserWindowOptions.y === 'number') {
+            const bounds = view.getBounds();
+            view.setBounds({
+                x: browserWindowOptions.x,
+                y: browserWindowOptions.y,
+                width: bounds.width,
+                height: bounds.height
+            });
+        }
+        // 设置视图背景颜色
+        if (typeof browserWindowOptions.backgroundColor === 'string') {
+            view.setBackgroundColor(browserWindowOptions.backgroundColor);
+        }
         // 可继续扩展其他动态属性
     }
     // 生成一个bv 做为预加载资源窗口，加载完成后销毁
     async createPreloadWebContents(url) {
         return new Promise(async (resolve, reject) => {
-            let bv = this.create({
+            let bv = await this.create({
                 type: 'BV',
                 url,
                 name: `preload-web-contents-${md5(url)}`,
@@ -871,7 +1177,7 @@ class WindowsManager {
 // @ts-ignore
 global['__ELECTRON_WINDOWS_MANAGER__'] = undefined;
 exports.isInitialized = false;
-const initialize = (preload, loadingViewUrl, errorViewUrl, preloadWebContentsUrl, webviewDomainWhiteList) => {
+const initialize = (preload, loadingViewUrl, errorViewUrl, preloadWebContentsConfig, webviewDomainWhiteList) => {
     // @ts-ignore
     if (exports.isInitialized && global['__ELECTRON_WINDOWS_MANAGER__']) {
         // @ts-ignore
@@ -879,7 +1185,7 @@ const initialize = (preload, loadingViewUrl, errorViewUrl, preloadWebContentsUrl
     }
     exports.isInitialized = true;
     // @ts-ignore
-    const wm = global['__ELECTRON_WINDOWS_MANAGER__'] = new WindowsManager(preload, loadingViewUrl, errorViewUrl, preloadWebContentsUrl, webviewDomainWhiteList);
+    const wm = global['__ELECTRON_WINDOWS_MANAGER__'] = new WindowsManager(preload, loadingViewUrl, errorViewUrl, preloadWebContentsConfig, webviewDomainWhiteList);
     eIpc.mainIPC.handleRenderer('__ELECTRON_WINDOW_MANAGER_IPC_CHANNEL__', async (data) => {
         if (data?.type === 'create') {
             const opt = data;
@@ -903,7 +1209,7 @@ const initialize = (preload, loadingViewUrl, errorViewUrl, preloadWebContentsUrl
                     winInitUrl: `${findWin?._initUrl || ''}`,
                 };
             }
-            const res = wm.create(opt.data);
+            const res = await wm.create(opt.data);
             return {
                 winId: Number(`${res.id || res._id || -1}`),
                 winName: `${res?._name || ''}`,
@@ -1039,9 +1345,9 @@ const initialize = (preload, loadingViewUrl, errorViewUrl, preloadWebContentsUrl
             return undefined;
         }
         // 是否开启预加载窗口
-        if (data?.type === 'setPreloadWebContentsUrl') {
+        if (data?.type === 'setPreloadWebContentsConfig') {
             const opt = data;
-            wm.setPreloadWebContentsUrl(opt.data);
+            wm.setPreloadWebContentsConfig(opt.data);
         }
         if (data?.type === 'createPreloadWebContents') {
             const opt = data;