[Feature Request]: BrowserWindow.setFullScreen shows window, despite options = { show: false }

[safris]

Preflight Checklist

• I have read the Contributing Guidelines for this project.
• I agree to follow the Code of Conduct that this project adheres to.
• I have searched the issue tracker for a bug report that matches the one I want to file, without success.

Electron Version

30.0.4

What operating system are you using?

macOS

Operating System Version

Sonoma 14.4.1

What arch are you using?

arm64 (including Apple Silicon)

Last Known Working Electron version

No response

Expected Behavior

Consider the following code:

const { app, BrowserWindow } = require("electron");

app.whenReady().then(() => {
  const win1 = new BrowserWindow({ x: 100, y: 100, show: false });
  win1.webContents.loadURL("https://developer.mozilla.org/en-US/docs/Web/API/History").then(() => {
    setTimeout(() => win1.show(), 5000);
  });

  win1.setFullScreen(true);
});

This code instantiates a BrowserWindow with { show: false }. Five seconds after it loads the given URL, BrowserWindow.show() is called to show the window.

Also, immediately after instantiation of the BrowserWindow, BrowserWindow.setFullScreen(true) is called.

Actual Behavior

The result is that the window is shown immediately when BrowserWindow.setFullScreen(true) is called.

I'm not sure what the expected behavior should be, because BrowserWindow.setFullScreen(true) may not make sense on a BrowserWindow that is now showing. Therefore, having BrowserWindow.setFullScreen(true) have the additional functionality to also show a BrowserWindow may be correct.

This is not reflected in the documentation, which begs the question if this functionality is intentional or accidental.

Here is a comment from an old issue touching on this functionality.

Testcase Gist URL

No response

Additional Information

No response