From c857c9b7e2575769a26769dfa32e967a3da26e99 Mon Sep 17 00:00:00 2001
From: Shelley Vohr <shelley.vohr@gmail.com>
Date: Mon, 17 Apr 2023 10:45:40 +0200
Subject: [PATCH] docs: add note to `win.setFullScreen(flag)` (#37921)

docs: add note to win.setFullScreen(flag)
---
 docs/api/browser-window.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index 5c873981064..2b47cd13ca3 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -992,6 +992,8 @@ Returns `boolean` - Whether the window is minimized.
 
 Sets whether the window should be in fullscreen mode.
 
+**Note:** On macOS, fullscreen transitions take place asynchronously. If further actions depend on the fullscreen state, use the ['enter-full-screen'](browser-window.md#event-enter-full-screen) or ['leave-full-screen'](browser-window.md#event-leave-full-screen) events.
+
 #### `win.isFullScreen()`
 
 Returns `boolean` - Whether the window is in fullscreen mode.