From 9ca9311b734d6e64b5bef81cf9dee6ef5acad784 Mon Sep 17 00:00:00 2001 From: Shelley Vohr Date: Thu, 19 Feb 2026 04:30:43 +0100 Subject: [PATCH] docs: note required windows in 'new-window-for-tab' event (#49851) docs: note required windows in new-window-for-tab --- docs/api/app.md | 4 +++- docs/api/base-window.md | 6 +++++- docs/api/browser-window.md | 6 +++++- 3 files changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/api/app.md b/docs/api/app.md index 70ea3d4061..3c608d0686 100644 --- a/docs/api/app.md +++ b/docs/api/app.md @@ -250,7 +250,9 @@ Returns: Emitted when the user clicks the native macOS new tab button. The new tab button is only visible if the current `BrowserWindow` has a -`tabbingIdentifier` +`tabbingIdentifier`. + +You must create a window in this handler in order for macOS tabbing to work as expected. ### Event: 'browser-window-blur' diff --git a/docs/api/base-window.md b/docs/api/base-window.md index 30d80fc7c1..4ab9afb72b 100644 --- a/docs/api/base-window.md +++ b/docs/api/base-window.md @@ -351,7 +351,11 @@ Emitted when the window has closed a sheet. #### Event: 'new-window-for-tab' _macOS_ -Emitted when the native new tab button is clicked. +Emitted when the user clicks the native macOS new tab button. The new +tab button is only visible if the current `BrowserWindow` has a +`tabbingIdentifier`. + +You must create a window in this handler in order for macOS tabbing to work as expected. #### Event: 'system-context-menu' _Windows_ _Linux_ diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md index c6a6797664..2779ed08fd 100644 --- a/docs/api/browser-window.md +++ b/docs/api/browser-window.md @@ -435,7 +435,11 @@ Emitted when the window has closed a sheet. #### Event: 'new-window-for-tab' _macOS_ -Emitted when the native new tab button is clicked. +Emitted when the user clicks the native macOS new tab button. The new +tab button is only visible if the current `BrowserWindow` has a +`tabbingIdentifier`. + +You must create a window in this handler in order for macOS tabbing to work as expected. #### Event: 'system-context-menu' _Windows_ _Linux_