| // Copyright 2019 The Chromium Authors |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #include "chrome/browser/ui/web_applications/web_app_launch_utils.h" |
| |
| #include <atomic> |
| #include <memory> |
| #include <optional> |
| |
| #include "base/check.h" |
| #include "base/check_op.h" |
| #include "base/command_line.h" |
| #include "base/debug/dump_without_crashing.h" |
| #include "base/feature_list.h" |
| #include "base/files/file_path.h" |
| #include "base/functional/bind.h" |
| #include "base/json/values_util.h" |
| #include "base/memory/raw_ptr.h" |
| #include "base/metrics/histogram_functions.h" |
| #include "base/numerics/safe_conversions.h" |
| #include "base/one_shot_event.h" |
| #include "base/strings/stringprintf.h" |
| #include "base/task/sequenced_task_runner.h" |
| #include "base/time/time.h" |
| #include "base/values.h" |
| #include "build/buildflag.h" |
| #include "build/chromeos_buildflags.h" |
| #include "chrome/browser/app_mode/app_mode_utils.h" |
| #include "chrome/browser/apps/app_service/app_launch_params.h" |
| #include "chrome/browser/apps/app_service/launch_utils.h" |
| #include "chrome/browser/apps/link_capturing/link_capturing_features.h" |
| #include "chrome/browser/profiles/profile.h" |
| #include "chrome/browser/profiles/profiles_state.h" |
| #include "chrome/browser/sessions/app_session_service.h" |
| #include "chrome/browser/sessions/app_session_service_factory.h" |
| #include "chrome/browser/sessions/session_service_base.h" |
| #include "chrome/browser/sessions/session_service_lookup.h" |
| #include "chrome/browser/ui/browser.h" |
| #include "chrome/browser/ui/browser_commands.h" |
| #include "chrome/browser/ui/browser_finder.h" |
| #include "chrome/browser/ui/browser_list.h" |
| #include "chrome/browser/ui/browser_navigator.h" |
| #include "chrome/browser/ui/browser_navigator_params.h" |
| #include "chrome/browser/ui/browser_tabstrip.h" |
| #include "chrome/browser/ui/browser_window.h" |
| #include "chrome/browser/ui/tabs/tab_enums.h" |
| #include "chrome/browser/ui/tabs/tab_model.h" |
| #include "chrome/browser/ui/tabs/tab_strip_model.h" |
| #include "chrome/browser/ui/web_applications/app_browser_controller.h" |
| #include "chrome/browser/ui/web_applications/web_app_browser_controller.h" |
| #include "chrome/browser/ui/web_applications/web_app_launch_process.h" |
| #include "chrome/browser/ui/web_applications/web_app_launch_utils.h" |
| #include "chrome/browser/ui/web_applications/web_app_tabbed_utils.h" |
| #include "chrome/browser/web_applications/locks/app_lock.h" |
| #include "chrome/browser/web_applications/mojom/user_display_mode.mojom-shared.h" |
| #include "chrome/browser/web_applications/os_integration/os_integration_manager.h" |
| #include "chrome/browser/web_applications/web_app_constants.h" |
| #include "chrome/browser/web_applications/web_app_helpers.h" |
| #include "chrome/browser/web_applications/web_app_install_utils.h" |
| #include "chrome/browser/web_applications/web_app_launch_params.h" |
| #include "chrome/browser/web_applications/web_app_launch_queue.h" |
| #include "chrome/browser/web_applications/web_app_provider.h" |
| #include "chrome/browser/web_applications/web_app_registrar.h" |
| #include "chrome/browser/web_applications/web_app_sync_bridge.h" |
| #include "chrome/browser/web_applications/web_app_tab_helper.h" |
| #include "chrome/browser/web_applications/web_app_ui_manager.h" |
| #include "chrome/browser/web_applications/web_app_utils.h" |
| #include "chromeos/constants/chromeos_features.h" |
| #include "components/services/app_service/public/cpp/app_launch_util.h" |
| #include "components/site_engagement/content/site_engagement_service.h" |
| #include "components/webapps/common/web_app_id.h" |
| #include "content/public/browser/navigation_controller.h" |
| #include "content/public/browser/navigation_entry.h" |
| #include "content/public/browser/render_frame_host.h" |
| #include "content/public/browser/site_instance.h" |
| #include "content/public/browser/web_contents.h" |
| #include "extensions/buildflags/buildflags.h" |
| #include "third_party/blink/public/common/renderer_preferences/renderer_preferences.h" |
| #include "ui/base/page_transition_types.h" |
| #include "ui/base/ui_base_types.h" |
| #include "ui/base/window_open_disposition.h" |
| #include "url/gurl.h" |
| |
| #if BUILDFLAG(ENABLE_EXTENSIONS) |
| #include "chrome/browser/ui/extensions/hosted_app_browser_controller.h" |
| #include "extensions/browser/extension_registry.h" |
| #include "extensions/common/extension.h" |
| #endif |
| |
| #if BUILDFLAG(IS_CHROMEOS) |
| #include "chromeos/components/kiosk/kiosk_utils.h" |
| #endif // BUILDFLAG(IS_CHROMEOS) |
| |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| #include "chrome/browser/ash/app_mode/web_app/web_kiosk_browser_controller_ash.h" |
| #include "chrome/browser/ash/system_web_apps/system_web_app_manager.h" |
| #include "chrome/browser/ash/system_web_apps/types/system_web_app_delegate.h" |
| #include "chrome/browser/ui/ash/system_web_apps/system_web_app_ui_utils.h" |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| |
| #if BUILDFLAG(IS_CHROMEOS_LACROS) |
| #include "chromeos/constants/chromeos_features.h" |
| #endif // BUILDFLAG(IS_CHROMEOS_LACROS) |
| |
| #if BUILDFLAG(IS_WIN) |
| #include "base/strings/utf_string_conversions.h" |
| #endif |
| |
| namespace web_app { |
| |
| namespace { |
| |
| Browser* ReparentWebContentsIntoAppBrowser(content::WebContents* contents, |
| Browser* target_browser, |
| const webapps::AppId& app_id, |
| bool as_pinned_home_tab) { |
| DCHECK(target_browser->is_type_app()); |
| Browser* source_browser = chrome::FindBrowserWithTab(contents); |
| |
| // In a reparent, the owning session service needs to be told it's tab |
| // has been removed, otherwise it will reopen the tab on restoration. |
| SessionServiceBase* service = |
| GetAppropriateSessionServiceForProfile(source_browser); |
| service->TabClosing(contents); |
| |
| TabStripModel* source_tabstrip = source_browser->tab_strip_model(); |
| TabStripModel* target_tabstrip = target_browser->tab_strip_model(); |
| |
| // Avoid causing the existing browser window to close if this is the last tab |
| // remaining. |
| if (source_tabstrip->count() == 1) { |
| chrome::NewTab(source_browser); |
| } |
| |
| if (as_pinned_home_tab) { |
| if (HasPinnedHomeTab(target_tabstrip)) { |
| // Insert the web contents into the pinned home tab and delete the |
| // existing home tab. |
| target_tabstrip->InsertDetachedTabAt( |
| /*index=*/0, |
| source_tabstrip->DetachTabAtForInsertion( |
| source_tabstrip->GetIndexOfWebContents(contents)), |
| (AddTabTypes::ADD_INHERIT_OPENER | AddTabTypes::ADD_ACTIVE | |
| AddTabTypes::ADD_PINNED)); |
| target_tabstrip->DetachAndDeleteWebContentsAt(1); |
| } else { |
| target_tabstrip->InsertDetachedTabAt( |
| /*index=*/0, |
| source_tabstrip->DetachTabAtForInsertion( |
| source_tabstrip->GetIndexOfWebContents(contents)), |
| (AddTabTypes::ADD_INHERIT_OPENER | AddTabTypes::ADD_ACTIVE | |
| AddTabTypes::ADD_PINNED)); |
| } |
| SetWebContentsIsPinnedHomeTab(target_tabstrip->GetWebContentsAt(0)); |
| } else { |
| MaybeAddPinnedHomeTab(target_browser, app_id); |
| target_tabstrip->AppendTab( |
| source_tabstrip->DetachTabAtForInsertion( |
| source_tabstrip->GetIndexOfWebContents(contents)), |
| true); |
| } |
| target_browser->window()->Show(); |
| |
| // The app window will be registered correctly, however the tab will not |
| // be correctly tracked. We need to do a reset to get the tab correctly |
| // tracked by the app service. |
| AppSessionService* app_service = |
| AppSessionServiceFactory::GetForProfile(target_browser->profile()); |
| app_service->ResetFromCurrentBrowsers(); |
| |
| return target_browser; |
| } |
| |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| const ash::SystemWebAppDelegate* GetSystemWebAppDelegate( |
| Browser* browser, |
| const webapps::AppId& app_id) { |
| auto system_app_type = |
| ash::GetSystemWebAppTypeForAppId(browser->profile(), app_id); |
| if (system_app_type) { |
| return ash::SystemWebAppManager::Get(browser->profile()) |
| ->GetSystemApp(*system_app_type); |
| } |
| return nullptr; |
| } |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| |
| #if BUILDFLAG(IS_CHROMEOS) |
| std::unique_ptr<AppBrowserController> CreateWebKioskBrowserController( |
| Browser* browser, |
| WebAppProvider* provider, |
| const webapps::AppId& app_id) { |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| const ash::SystemWebAppDelegate* system_app = |
| GetSystemWebAppDelegate(browser, app_id); |
| return std::make_unique<ash::WebKioskBrowserControllerAsh>( |
| *provider, browser, app_id, system_app); |
| #else |
| // TODO(b/242023891): Add web Kiosk browser controller for Lacros. |
| return nullptr; |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| } |
| #endif // BUILDFLAG(IS_CHROMEOS) |
| |
| std::unique_ptr<AppBrowserController> CreateWebAppBrowserController( |
| Browser* browser, |
| WebAppProvider* provider, |
| const webapps::AppId& app_id) { |
| bool should_have_tab_strip_for_swa = false; |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| const ash::SystemWebAppDelegate* system_app = |
| GetSystemWebAppDelegate(browser, app_id); |
| should_have_tab_strip_for_swa = |
| system_app && system_app->ShouldHaveTabStrip(); |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| const bool has_tab_strip = |
| !browser->is_type_app_popup() && |
| (should_have_tab_strip_for_swa || |
| provider->registrar_unsafe().IsTabbedWindowModeEnabled(app_id)); |
| return std::make_unique<WebAppBrowserController>(*provider, browser, app_id, |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| system_app, |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| has_tab_strip); |
| } |
| |
| std::unique_ptr<AppBrowserController> MaybeCreateHostedAppBrowserController( |
| Browser* browser, |
| const webapps::AppId& app_id) { |
| #if BUILDFLAG(ENABLE_EXTENSIONS) |
| const extensions::Extension* extension = |
| extensions::ExtensionRegistry::Get(browser->profile()) |
| ->GetExtensionById(app_id, extensions::ExtensionRegistry::EVERYTHING); |
| if (extension && extension->is_hosted_app()) { |
| return std::make_unique<extensions::HostedAppBrowserController>(browser); |
| } |
| #endif // BUILDFLAG(ENABLE_EXTENSIONS) |
| return nullptr; |
| } |
| |
| base::Value::Dict ToDebugDict(const apps::AppLaunchParams& params) { |
| base::Value::Dict value; |
| value.Set("app_id", params.app_id); |
| value.Set("launch_id", params.launch_id); |
| value.Set("container", static_cast<int>(params.container)); |
| value.Set("disposition", static_cast<int>(params.disposition)); |
| value.Set("override_url", params.override_url.spec()); |
| value.Set("override_bounds", params.override_bounds.ToString()); |
| value.Set("override_app_name", params.override_app_name); |
| value.Set("restore_id", params.restore_id); |
| #if BUILDFLAG(IS_WIN) |
| value.Set("command_line", |
| base::WideToUTF8(params.command_line.GetCommandLineString())); |
| #else |
| value.Set("command_line", params.command_line.GetCommandLineString()); |
| #endif |
| value.Set("current_directory", |
| base::FilePathToValue(params.current_directory)); |
| value.Set("launch_source", static_cast<int>(params.launch_source)); |
| value.Set("display_id", base::saturated_cast<int>(params.display_id)); |
| base::Value::List files_list; |
| for (const base::FilePath& file : params.launch_files) { |
| files_list.Append(base::FilePathToValue(file)); |
| } |
| value.Set("launch_files", std::move(files_list)); |
| value.Set("intent", params.intent ? "<set>" : "<not set>"); |
| value.Set("url_handler_launch_url", |
| params.url_handler_launch_url.value_or(GURL()).spec()); |
| value.Set("protocol_handler_launch_url", |
| params.protocol_handler_launch_url.value_or(GURL()).spec()); |
| value.Set("omit_from_session_restore", params.omit_from_session_restore); |
| return value; |
| } |
| |
| // Returns true if an auxiliary browsing context is getting created, so |
| // navigation should be done in the same container that it was triggered in. |
| bool IsAuxiliaryBrowsingContext(const NavigateParams& nav_params) { |
| if ((nav_params.contents_to_insert && |
| nav_params.contents_to_insert->HasOpener()) || |
| nav_params.opener) { |
| return true; |
| } |
| return false; |
| } |
| |
| // Searches all browsers and tabs to find an applicable browser and (contained) |
| // tab that matches the given `requested_display_mode`. |
| std::optional<std::pair<Browser*, int>> GetAppHostForCapturing( |
| const Profile& profile, |
| const webapps::AppId& app_id, |
| const mojom::UserDisplayMode requested_display_mode) { |
| for (Browser* browser : BrowserList::GetInstance()->OrderedByActivation()) { |
| if (browser->IsAttemptingToCloseBrowser() || browser->IsBrowserClosing()) { |
| continue; |
| } |
| if (!(browser->is_type_normal() || browser->is_type_app())) { |
| continue; |
| } |
| if (browser->profile() != &profile) { |
| continue; |
| } |
| switch (requested_display_mode) { |
| case mojom::UserDisplayMode::kBrowser: |
| if (!(browser->is_type_normal())) { |
| continue; |
| } |
| if (AppBrowserController::IsWebApp(browser)) { |
| continue; |
| } |
| break; |
| case mojom::UserDisplayMode::kStandalone: |
| case mojom::UserDisplayMode::kTabbed: |
| if (!(browser->is_type_app())) { |
| continue; |
| } |
| if (!AppBrowserController::IsWebApp(browser)) { |
| continue; |
| } |
| } |
| |
| // The active web contents should have preference if it is in scope. |
| if (browser->tab_strip_model()->active_index() != TabStripModel::kNoTab) { |
| const webapps::AppId* tab_app_id = WebAppTabHelper::GetAppId( |
| browser->tab_strip_model()->GetActiveWebContents()); |
| if (tab_app_id && *tab_app_id == app_id) { |
| return std::pair(browser, browser->tab_strip_model()->active_index()); |
| } |
| } |
| // Otherwise, use the first one for the app. |
| for (int i = 0; i < browser->tab_strip_model()->count(); ++i) { |
| content::WebContents* contents = |
| browser->tab_strip_model()->GetWebContentsAt(i); |
| const webapps::AppId* tab_app_id = WebAppTabHelper::GetAppId(contents); |
| if (tab_app_id && *tab_app_id == app_id) { |
| return std::pair(browser, i); |
| } |
| } |
| } |
| return std::nullopt; |
| } |
| |
| } // namespace |
| |
| std::optional<webapps::AppId> GetWebAppForActiveTab(const Browser* browser) { |
| const WebAppProvider* const provider = |
| WebAppProvider::GetForWebApps(browser->profile()); |
| if (!provider) { |
| return std::nullopt; |
| } |
| |
| const content::WebContents* const web_contents = |
| browser->tab_strip_model()->GetActiveWebContents(); |
| if (!web_contents) { |
| return std::nullopt; |
| } |
| |
| return provider->registrar_unsafe().FindInstalledAppWithUrlInScope( |
| web_contents->GetPrimaryMainFrame()->GetLastCommittedURL()); |
| } |
| |
| void PrunePreScopeNavigationHistory(const GURL& scope, |
| content::WebContents* contents) { |
| content::NavigationController& navigation_controller = |
| contents->GetController(); |
| if (!navigation_controller.CanPruneAllButLastCommitted()) { |
| return; |
| } |
| |
| int index = navigation_controller.GetEntryCount() - 1; |
| while (index >= 0 && |
| IsInScope(navigation_controller.GetEntryAtIndex(index)->GetURL(), |
| scope)) { |
| --index; |
| } |
| |
| while (index >= 0) { |
| navigation_controller.RemoveEntryAtIndex(index); |
| --index; |
| } |
| } |
| |
| Browser* ReparentWebAppForActiveTab(Browser* browser) { |
| std::optional<webapps::AppId> app_id = GetWebAppForActiveTab(browser); |
| if (!app_id) { |
| return nullptr; |
| } |
| return ReparentWebContentsIntoAppBrowser( |
| browser->tab_strip_model()->GetActiveWebContents(), *app_id); |
| } |
| |
| Browser* ReparentWebContentsIntoAppBrowser(content::WebContents* contents, |
| const webapps::AppId& app_id) { |
| Profile* profile = Profile::FromBrowserContext(contents->GetBrowserContext()); |
| // Incognito tabs reparent correctly, but remain incognito without any |
| // indication to the user, so disallow it. |
| DCHECK(!profile->IsOffTheRecord()); |
| |
| // Clear navigation history that occurred before the user most recently |
| // entered the app's scope. The minimal-ui Back button will be initially |
| // disabled if the previous page was outside scope. Packaged apps are not |
| // affected. |
| WebAppProvider* provider = WebAppProvider::GetForWebApps(profile); |
| WebAppRegistrar& registrar = provider->registrar_unsafe(); |
| const WebApp* web_app = registrar.GetAppById(app_id); |
| if (!web_app) { |
| return nullptr; |
| } |
| |
| if (registrar.IsInstalled(app_id)) { |
| std::optional<GURL> app_scope = registrar.GetAppScope(app_id); |
| if (!app_scope) { |
| app_scope = registrar.GetAppStartUrl(app_id).GetWithoutFilename(); |
| } |
| |
| PrunePreScopeNavigationHistory(*app_scope, contents); |
| } |
| |
| auto launch_url = contents->GetLastCommittedURL(); |
| UpdateLaunchStats(contents, app_id, launch_url); |
| RecordLaunchMetrics(app_id, apps::LaunchContainer::kLaunchContainerWindow, |
| apps::LaunchSource::kFromReparenting, launch_url, |
| contents); |
| |
| if (web_app->launch_handler() |
| .value_or(LaunchHandler{}) |
| .TargetsExistingClients() || |
| registrar.IsPreventCloseEnabled(web_app->app_id())) { |
| if (AppBrowserController::FindForWebApp(*profile, app_id)) { |
| // TODO(crbug.com/40246677): Use apps::AppServiceProxy::LaunchAppWithUrl() |
| // instead to ensure all the usual wrapping code around web app launches |
| // gets executed. |
| apps::AppLaunchParams params( |
| app_id, apps::LaunchContainer::kLaunchContainerWindow, |
| WindowOpenDisposition::CURRENT_TAB, apps::LaunchSource::kFromOmnibox); |
| params.override_url = launch_url; |
| content::WebContents* new_web_contents = |
| WebAppLaunchProcess::CreateAndRun( |
| *profile, registrar, provider->os_integration_manager(), params); |
| contents->Close(); |
| return chrome::FindBrowserWithTab(new_web_contents); |
| } |
| } |
| |
| Browser* browser = nullptr; |
| |
| if (registrar.IsTabbedWindowModeEnabled(app_id)) { |
| browser = AppBrowserController::FindForWebApp(*profile, app_id); |
| } |
| |
| if (!browser) { |
| browser = Browser::Create(Browser::CreateParams::CreateForApp( |
| GenerateApplicationNameFromAppId(app_id), true /* trusted_source */, |
| gfx::Rect(), profile, true /* user_gesture */)); |
| |
| // If the current url isn't in scope, then set the initial url on the |
| // AppBrowserController so that the 'x' button still shows up. |
| CHECK(browser->app_controller()); |
| browser->app_controller()->MaybeSetInitialUrlOnReparentTab(); |
| } |
| |
| bool as_pinned_home_tab = |
| browser->app_controller()->IsUrlInHomeTabScope(launch_url); |
| |
| return ReparentWebContentsIntoAppBrowser(contents, browser, app_id, |
| as_pinned_home_tab); |
| } |
| |
| void SetWebContentsIsPinnedHomeTab(content::WebContents* contents) { |
| auto* helper = WebAppTabHelper::FromWebContents(contents); |
| helper->set_is_pinned_home_tab(true); |
| } |
| |
| std::unique_ptr<AppBrowserController> MaybeCreateAppBrowserController( |
| Browser* browser) { |
| std::unique_ptr<AppBrowserController> controller; |
| const webapps::AppId app_id = |
| GetAppIdFromApplicationName(browser->app_name()); |
| auto* const provider = |
| WebAppProvider::GetForLocalAppsUnchecked(browser->profile()); |
| if (provider && provider->registrar_unsafe().IsInstalled(app_id)) { |
| #if BUILDFLAG(IS_CHROMEOS) |
| if (chromeos::IsKioskSession()) { |
| controller = CreateWebKioskBrowserController(browser, provider, app_id); |
| } else { |
| controller = CreateWebAppBrowserController(browser, provider, app_id); |
| } |
| #else |
| controller = CreateWebAppBrowserController(browser, provider, app_id); |
| #endif // BUILDFLAG(IS_CHROMEOS) |
| } else { |
| controller = MaybeCreateHostedAppBrowserController(browser, app_id); |
| } |
| if (controller) { |
| controller->Init(); |
| } |
| return controller; |
| } |
| |
| void MaybeAddPinnedHomeTab(Browser* browser, const std::string& app_id) { |
| WebAppRegistrar& registrar = |
| WebAppProvider::GetForLocalAppsUnchecked(browser->profile()) |
| ->registrar_unsafe(); |
| std::optional<GURL> pinned_home_tab_url = |
| registrar.GetAppPinnedHomeTabUrl(app_id); |
| |
| if (registrar.IsTabbedWindowModeEnabled(app_id) && |
| !HasPinnedHomeTab(browser->tab_strip_model()) && |
| pinned_home_tab_url.has_value()) { |
| NavigateParams home_tab_nav_params(browser, pinned_home_tab_url.value(), |
| ui::PAGE_TRANSITION_AUTO_BOOKMARK); |
| home_tab_nav_params.disposition = WindowOpenDisposition::NEW_BACKGROUND_TAB; |
| home_tab_nav_params.tabstrip_add_types |= AddTabTypes::ADD_PINNED; |
| Navigate(&home_tab_nav_params); |
| |
| content::WebContents* const web_contents = |
| home_tab_nav_params.navigated_or_inserted_contents; |
| |
| if (web_contents) { |
| SetWebContentsIsPinnedHomeTab(web_contents); |
| } |
| } |
| } |
| |
| Browser::CreateParams CreateParamsForApp(const webapps::AppId& app_id, |
| bool is_popup, |
| bool trusted_source, |
| const gfx::Rect& window_bounds, |
| Profile* profile, |
| bool user_gesture) { |
| std::string app_name = GenerateApplicationNameFromAppId(app_id); |
| Browser::CreateParams params = |
| is_popup |
| ? Browser::CreateParams::CreateForAppPopup( |
| app_name, trusted_source, window_bounds, profile, user_gesture) |
| : Browser::CreateParams::CreateForApp( |
| app_name, trusted_source, window_bounds, profile, user_gesture); |
| params.initial_show_state = IsRunningInForcedAppMode() |
| ? ui::SHOW_STATE_FULLSCREEN |
| : ui::SHOW_STATE_DEFAULT; |
| return params; |
| } |
| |
| Browser* CreateWebAppWindowMaybeWithHomeTab( |
| const webapps::AppId& app_id, |
| const Browser::CreateParams& params) { |
| CHECK(params.type == Browser::Type::TYPE_APP_POPUP || |
| params.type == Browser::Type::TYPE_APP); |
| Browser* browser = Browser::Create(params); |
| CHECK(GenerateApplicationNameFromAppId(app_id) == browser->app_name()); |
| if (params.type != Browser::Type::TYPE_APP_POPUP) { |
| MaybeAddPinnedHomeTab(browser, app_id); |
| } |
| return browser; |
| } |
| |
| Browser* CreateWebAppWindowFromNavigationParams( |
| const webapps::AppId& app_id, |
| const NavigateParams& navigate_params, |
| bool should_create_app_popup = false) { |
| Browser::CreateParams app_browser_params = CreateParamsForApp( |
| app_id, should_create_app_popup, /*trusted_source=*/true, |
| navigate_params.window_features.bounds, |
| navigate_params.initiating_profile, navigate_params.user_gesture); |
| Browser* created_browser = |
| CreateWebAppWindowMaybeWithHomeTab(app_id, app_browser_params); |
| return created_browser; |
| } |
| |
| // If the `contents` is not a nullptr, will enqueue the given url in the launch |
| // params for this web contents. Does not check if the url is within scope of |
| // the app. |
| // TODO(crbug.com/359605935): Move this logic to occur later after/in |
| // CreateTargetContents in browser_navigator.cc, to ensure `contents` isn't a |
| // nullptr. |
| void MaybeEnqueueLaunchParams(content::WebContents* contents, |
| const webapps::AppId& app_id, |
| const GURL& url, |
| bool wait_for_navigation_to_complete) { |
| if (!contents) { |
| return; |
| } |
| WebAppLaunchParams launch_params; |
| launch_params.started_new_navigation = wait_for_navigation_to_complete; |
| launch_params.app_id = app_id; |
| launch_params.target_url = url; |
| WebAppTabHelper::FromWebContents(contents)->EnsureLaunchQueue().Enqueue( |
| std::move(launch_params)); |
| } |
| |
| content::WebContents* NavigateWebAppUsingParams(const std::string& app_id, |
| NavigateParams& nav_params) { |
| if (nav_params.browser->app_controller() && |
| nav_params.browser->app_controller()->IsUrlInHomeTabScope( |
| nav_params.url)) { |
| // Navigations to the home tab URL in tabbed apps should happen in the home |
| // tab. |
| nav_params.browser->tab_strip_model()->ActivateTabAt(0); |
| content::WebContents* home_tab_web_contents = |
| nav_params.browser->tab_strip_model()->GetWebContentsAt(0); |
| GURL previous_home_tab_url = home_tab_web_contents->GetLastCommittedURL(); |
| if (previous_home_tab_url == nav_params.url) { |
| // URL is identical so no need for the navigation. |
| return home_tab_web_contents; |
| } |
| nav_params.disposition = WindowOpenDisposition::CURRENT_TAB; |
| } |
| |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| Browser* browser = nav_params.browser; |
| const std::optional<ash::SystemWebAppType> capturing_system_app_type = |
| ash::GetCapturingSystemAppForURL(browser->profile(), nav_params.url); |
| if (capturing_system_app_type && |
| (!browser || |
| !IsBrowserForSystemWebApp(browser, capturing_system_app_type.value()))) { |
| // Web app launch process should receive the correct `NavigateParams` |
| // argument from system web app launches, so that Navigate() call below |
| // succeeds (i.e. don't trigger system web app link capture). |
| // |
| // This block safe guards against misuse of APIs (that can cause |
| // GetCapturingSystemAppForURL returning the wrong value). |
| // |
| // TODO(http://crbug.com/1408946): Remove this block when we find a better |
| // way to prevent API misuse (e.g. by ensuring test coverage for new |
| // features that could trigger this code) or this code path is no longer |
| // possible. |
| base::debug::DumpWithoutCrashing(); |
| return nullptr; |
| } |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| |
| #if BUILDFLAG(IS_CHROMEOS_LACROS) |
| // Highly experimental feature to isolate web app application with a different |
| // storage partition. |
| if (base::FeatureList::IsEnabled( |
| chromeos::features::kExperimentalWebAppStoragePartitionIsolation)) { |
| // TODO(crbug.com/40260833): Cover other app launch paths (e.g. restore |
| // apps). |
| auto partition_config = content::StoragePartitionConfig::Create( |
| nav_params.browser->profile(), |
| /*partition_domain=*/kExperimentalWebAppStorageParitionDomain, |
| /*partition_name=*/app_id, /*in_memory=*/false); |
| |
| auto site_instance = content::SiteInstance::CreateForFixedStoragePartition( |
| nav_params.browser->profile(), nav_params.url, partition_config); |
| |
| content::WebContents::CreateParams params(nav_params.browser->profile(), |
| std::move(site_instance)); |
| std::unique_ptr<content::WebContents> new_contents = |
| content::WebContents::Create(params); |
| content::NavigationController::LoadURLParams load_url_params( |
| nav_params.url); |
| |
| new_contents->GetController().LoadURLWithParams(load_url_params); |
| |
| nav_params.contents_to_insert = std::move(new_contents); |
| } |
| #endif // BUILDFLAG(IS_CHROMEOS_LACROS) |
| |
| Navigate(&nav_params); |
| |
| content::WebContents* const web_contents = |
| nav_params.navigated_or_inserted_contents; |
| |
| return web_contents; |
| } |
| |
| void RecordAppWindowLaunchMetric(Profile* profile, |
| const std::string& app_id, |
| apps::LaunchSource launch_source) { |
| WebAppProvider* provider = WebAppProvider::GetForLocalAppsUnchecked(profile); |
| if (!provider) { |
| return; |
| } |
| |
| const WebApp* web_app = provider->registrar_unsafe().GetAppById(app_id); |
| if (!web_app) { |
| return; |
| } |
| |
| DisplayMode display = |
| provider->registrar_unsafe().GetEffectiveDisplayModeFromManifest(app_id); |
| if (display != DisplayMode::kUndefined) { |
| DCHECK_LT(DisplayMode::kUndefined, display); |
| DCHECK_LE(display, DisplayMode::kMaxValue); |
| base::UmaHistogramEnumeration("Launch.WebAppDisplayMode", display); |
| if (provider->registrar_unsafe().IsShortcutApp(app_id)) { |
| base::UmaHistogramEnumeration( |
| "Launch.Window.CreateShortcutApp.WebAppDisplayMode", display); |
| } |
| } |
| |
| // Reparenting launches don't respect the launch_handler setting. |
| if (launch_source != apps::LaunchSource::kFromReparenting) { |
| base::UmaHistogramEnumeration( |
| "Launch.WebAppLaunchHandlerClientMode", |
| web_app->launch_handler().value_or(LaunchHandler()).client_mode); |
| } |
| |
| base::UmaHistogramEnumeration("Launch.WebApp.DiyOrCrafted", |
| web_app->is_diy_app() |
| ? LaunchedAppType::kDiy |
| : LaunchedAppType::kCrafted); |
| } |
| |
| void RecordAppTabLaunchMetric(Profile* profile, |
| const std::string& app_id, |
| apps::LaunchSource launch_source) { |
| WebAppProvider* provider = WebAppProvider::GetForLocalAppsUnchecked(profile); |
| if (!provider) { |
| return; |
| } |
| |
| const WebApp* web_app = provider->registrar_unsafe().GetAppById(app_id); |
| if (!web_app) { |
| return; |
| } |
| |
| DisplayMode display = |
| provider->registrar_unsafe().GetEffectiveDisplayModeFromManifest(app_id); |
| if (display != DisplayMode::kUndefined) { |
| DCHECK_LT(DisplayMode::kUndefined, display); |
| DCHECK_LE(display, DisplayMode::kMaxValue); |
| base::UmaHistogramEnumeration("Launch.BrowserTab.WebAppDisplayMode", |
| display); |
| if (provider->registrar_unsafe().IsShortcutApp(app_id)) { |
| base::UmaHistogramEnumeration( |
| "Launch.BrowserTab.CreateShortcutApp.WebAppDisplayMode", display); |
| } |
| } |
| |
| // Reparenting launches don't respect the launch_handler setting. |
| if (launch_source != apps::LaunchSource::kFromReparenting) { |
| base::UmaHistogramEnumeration( |
| "Launch.BrowserTab.WebAppLaunchHandlerClientMode", |
| web_app->launch_handler().value_or(LaunchHandler()).client_mode); |
| } |
| } |
| |
| void RecordLaunchMetrics(const webapps::AppId& app_id, |
| apps::LaunchContainer container, |
| apps::LaunchSource launch_source, |
| const GURL& launch_url, |
| content::WebContents* web_contents) { |
| Profile* profile = |
| Profile::FromBrowserContext(web_contents->GetBrowserContext()); |
| |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| // System web apps have different launch paths compared with web apps, and |
| // those paths aren't configurable. So their launch metrics shouldn't be |
| // reported to avoid skewing web app metrics. |
| DCHECK(!ash::GetSystemWebAppTypeForAppId(profile, app_id)) |
| << "System web apps shouldn't be included in web app launch metrics"; |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| |
| if (container == apps::LaunchContainer::kLaunchContainerWindow) { |
| RecordAppWindowLaunchMetric(profile, app_id, launch_source); |
| } |
| if (container == apps::LaunchContainer::kLaunchContainerTab) { |
| RecordAppTabLaunchMetric(profile, app_id, launch_source); |
| } |
| |
| base::UmaHistogramEnumeration("WebApp.LaunchSource", launch_source); |
| base::UmaHistogramEnumeration("WebApp.LaunchContainer", container); |
| } |
| |
| void UpdateLaunchStats(content::WebContents* web_contents, |
| const webapps::AppId& app_id, |
| const GURL& launch_url) { |
| CHECK(web_contents != nullptr); |
| Profile* profile = |
| Profile::FromBrowserContext(web_contents->GetBrowserContext()); |
| |
| WebAppProvider::GetForLocalAppsUnchecked(profile) |
| ->sync_bridge_unsafe() |
| .SetAppLastLaunchTime(app_id, base::Time::Now()); |
| |
| #if BUILDFLAG(IS_CHROMEOS_ASH) |
| if (ash::GetSystemWebAppTypeForAppId(profile, app_id)) { |
| // System web apps doesn't use the rest of the stats. |
| return; |
| } |
| #endif // BUILDFLAG(IS_CHROMEOS_ASH) |
| |
| // Update the launch time in the site engagement service. A recent web |
| // app launch will provide an engagement boost to the origin. |
| site_engagement::SiteEngagementService::Get(profile) |
| ->SetLastShortcutLaunchTime(web_contents, app_id, launch_url); |
| } |
| |
| void LaunchWebApp(apps::AppLaunchParams params, |
| LaunchWebAppWindowSetting launch_setting, |
| Profile& profile, |
| WithAppResources& lock, |
| LaunchWebAppDebugValueCallback callback) { |
| base::Value::Dict debug_value; |
| debug_value.Set("launch_params", ToDebugDict(params)); |
| debug_value.Set("launch_window_setting", static_cast<int>(launch_setting)); |
| |
| if (launch_setting == LaunchWebAppWindowSetting::kOverrideWithWebAppConfig) { |
| DisplayMode display_mode = |
| lock.registrar().GetAppEffectiveDisplayMode(params.app_id); |
| switch (display_mode) { |
| case DisplayMode::kUndefined: |
| case DisplayMode::kFullscreen: |
| case DisplayMode::kBrowser: |
| params.container = apps::LaunchContainer::kLaunchContainerTab; |
| break; |
| case DisplayMode::kMinimalUi: |
| case DisplayMode::kWindowControlsOverlay: |
| case DisplayMode::kTabbed: |
| case DisplayMode::kBorderless: |
| case DisplayMode::kPictureInPicture: |
| case DisplayMode::kStandalone: |
| params.container = apps::LaunchContainer::kLaunchContainerWindow; |
| break; |
| } |
| } |
| |
| DCHECK_NE(params.container, apps::LaunchContainer::kLaunchContainerNone); |
| |
| apps::LaunchContainer container; |
| Browser* browser = nullptr; |
| content::WebContents* web_contents = nullptr; |
| // Do not launch anything if the profile is being deleted. |
| if (Browser::GetCreationStatusForProfile(&profile) == |
| Browser::CreationStatus::kOk) { |
| if (lock.registrar().IsInstalled(params.app_id)) { |
| container = params.container; |
| if (WebAppLaunchProcess::GetOpenApplicationCallbackForTesting()) { |
| WebAppLaunchProcess::GetOpenApplicationCallbackForTesting().Run( |
| std::move(params)); |
| } else { |
| web_contents = WebAppLaunchProcess::CreateAndRun( |
| profile, lock.registrar(), lock.os_integration_manager(), params); |
| } |
| if (web_contents) { |
| browser = chrome::FindBrowserWithTab(web_contents); |
| } |
| } else { |
| debug_value.Set("error", "Unknown app id."); |
| // Open an empty browser window as the app_id is invalid. |
| DVLOG(1) << "Cannot launch app with unknown id: " << params.app_id; |
| container = apps::LaunchContainer::kLaunchContainerNone; |
| browser = apps::CreateBrowserWithNewTabPage(&profile); |
| } |
| } else { |
| std::string error_str = base::StringPrintf( |
| "Cannot launch app %s without profile creation: %d", |
| params.app_id.c_str(), |
| static_cast<int>(Browser::GetCreationStatusForProfile(&profile))); |
| debug_value.Set("error", error_str); |
| DVLOG(1) << error_str; |
| } |
| |
| debug_value.Set("web_contents", base::ToString(web_contents)); |
| debug_value.Set("browser", base::ToString(browser)); |
| |
| base::SequencedTaskRunner::GetCurrentDefault()->PostTask( |
| FROM_HERE, |
| base::BindOnce(std::move(callback), |
| browser ? browser->AsWeakPtr() : nullptr, |
| web_contents ? web_contents->GetWeakPtr() : nullptr, |
| container, base::Value(std::move(debug_value)))); |
| } |
| |
| std::optional<std::pair<Browser*, int>> MaybeHandleAppNavigation( |
| Profile* profile, |
| const NavigateParams& params) { |
| if (params.open_pwa_window_if_possible) { |
| std::optional<webapps::AppId> app_id = |
| web_app::FindInstalledAppWithUrlInScope(profile, params.url, |
| /*window_only=*/true); |
| if (!app_id && params.force_open_pwa_window) { |
| // In theory |force_open_pwa_window| should only be set if we know a |
| // matching PWA is installed. However, we can reach here if |
| // `WebAppRegistrar` hasn't finished starting yet, which can happen if |
| // Chrome is launched with the URL of an isolated app as an argument. |
| // This isn't a supported way to launch isolated apps, so we can cancel |
| // the navigation, but if we want to support it in the future we'll need |
| // to block until `WebAppRegistrar` is loaded. |
| return std::pair(/*browser=*/nullptr, -1); |
| } |
| if (app_id) { |
| // Reuse the existing browser for in-app same window navigations. |
| bool navigating_same_app = |
| params.browser && |
| web_app::AppBrowserController::IsForWebApp(params.browser, *app_id); |
| if (navigating_same_app) { |
| if (params.disposition == WindowOpenDisposition::CURRENT_TAB) { |
| return std::pair(params.browser, -1); |
| } |
| |
| // If the browser window does not yet have any tabs, and we are |
| // attempting to add the first tab to it, allow for it to be reused. |
| bool navigating_new_tab = |
| params.disposition == WindowOpenDisposition::NEW_FOREGROUND_TAB || |
| params.disposition == WindowOpenDisposition::NEW_BACKGROUND_TAB; |
| bool browser_has_no_tabs = |
| params.browser && params.browser->tab_strip_model()->empty(); |
| if (navigating_new_tab && browser_has_no_tabs) { |
| return std::pair(params.browser, -1); |
| } |
| } |
| |
| auto GetOriginSpecified = [](const NavigateParams& params) { |
| return params.window_features.has_x && params.window_features.has_y |
| ? Browser::ValueSpecified::kSpecified |
| : Browser::ValueSpecified::kUnspecified; |
| }; |
| |
| // App popups are handled in the switch statement in |
| // `GetBrowserAndTabForDisposition()`. |
| if (params.disposition != WindowOpenDisposition::NEW_POPUP && |
| Browser::GetCreationStatusForProfile(profile) == |
| Browser::CreationStatus::kOk) { |
| std::string app_name = |
| web_app::GenerateApplicationNameFromAppId(*app_id); |
| // Installed PWAs are considered trusted. |
| Browser::CreateParams browser_params = |
| Browser::CreateParams::CreateForApp( |
| app_name, /*trusted_source=*/true, |
| params.window_features.bounds, profile, params.user_gesture); |
| browser_params.initial_origin_specified = GetOriginSpecified(params); |
| Browser* browser = Browser::Create(browser_params); |
| return std::pair(browser, -1); |
| } |
| } |
| } |
| |
| // Below here handles the states outlined in |
| // https://bit.ly/pwa-navigation-capturing |
| if (!apps::features::IsNavigationCapturingReimplEnabled() || |
| params.started_from_context_menu) { |
| return std::nullopt; |
| } |
| |
| web_app::WebAppProvider* provider = |
| web_app::WebAppProvider::GetForWebApps(profile); |
| web_app::WebAppRegistrar& registrar = provider->registrar_unsafe(); |
| |
| auto OpensInStandaloneExperience = |
| [®istrar](const webapps::AppId& app_id) -> bool { |
| return registrar.GetAppEffectiveDisplayMode(app_id) != |
| DisplayMode::kBrowser; |
| }; |
| |
| std::optional<webapps::AppId> controlling_app_id = |
| registrar.FindAppThatCapturesLinksInScope(params.url); |
| |
| std::optional<webapps::AppId> current_browser_app_id = |
| params.browser && web_app::AppBrowserController::IsWebApp(params.browser) |
| ? std::optional(params.browser->app_controller()->app_id()) |
| : std::nullopt; |
| |
| const bool is_user_modified_click = |
| params.disposition == WindowOpenDisposition::NEW_WINDOW || |
| params.disposition == WindowOpenDisposition::NEW_BACKGROUND_TAB; |
| |
| // Case: Any click (user modified or non-modified) with auxiliary browsing |
| // context. Only needs to be handled if it is triggered in the context of an |
| // app browser. |
| if (IsAuxiliaryBrowsingContext(params)) { |
| if (current_browser_app_id.has_value()) { |
| Browser* app_window = CreateWebAppWindowFromNavigationParams( |
| *current_browser_app_id, params, |
| params.disposition == WindowOpenDisposition::NEW_POPUP); |
| return std::pair(app_window, -1); |
| } |
| return std::nullopt; |
| } |
| |
| // Case: User-modified clicks. |
| if (is_user_modified_click) { |
| if (current_browser_app_id.has_value()) { |
| // Case: Shift-clicks with a new top level browsing context. |
| if (params.disposition == WindowOpenDisposition::NEW_WINDOW && |
| controlling_app_id.has_value() && |
| OpensInStandaloneExperience(*controlling_app_id)) { |
| Browser* app_window = |
| CreateWebAppWindowFromNavigationParams(*controlling_app_id, params); |
| |
| // TODO(crbug.com/359605935): Move this logic to occur later after/in |
| // CreateTargetContents in browser_navigator.cc, to ensure `contents` |
| // isn't a nullptr. |
| MaybeEnqueueLaunchParams(params.contents_to_insert.get(), |
| *controlling_app_id, params.url, |
| /*wait_for_navigation_to_complete=*/true); |
| return std::pair(app_window, -1); |
| } |
| |
| const webapps::AppId& current_app_id = *current_browser_app_id; |
| |
| // Case: Middle clicks with a new top level browsing context. |
| if (params.disposition == WindowOpenDisposition::NEW_BACKGROUND_TAB && |
| OpensInStandaloneExperience(current_app_id) && |
| registrar.IsUrlInAppScope(params.url, current_app_id) && |
| registrar.CapturesLinksInScope(current_app_id)) { |
| if (!params.browser->app_controller()->ShouldHideNewTabButton()) { |
| // Apps that support tabbed mode can open a new tab in the current app |
| // browser itself. |
| return std::pair(params.browser, -1); |
| } else { |
| Browser* app_window = |
| CreateWebAppWindowFromNavigationParams(current_app_id, params); |
| |
| // TODO(crbug.com/359605935): Move this logic to occur later after/in |
| // CreateTargetContents in browser_navigator.cc, to ensure `contents` |
| // isn't a nullptr. |
| MaybeEnqueueLaunchParams(params.contents_to_insert.get(), |
| current_app_id, params.url, |
| /*wait_for_navigation_to_complete=*/true); |
| return std::pair(app_window, -1); |
| } |
| } |
| } |
| return std::nullopt; |
| } |
| |
| // Case: Left click, non-user-modified. Capturable. |
| if (params.disposition == WindowOpenDisposition::NEW_FOREGROUND_TAB && |
| controlling_app_id) { |
| const webapps::AppId& app_id = controlling_app_id.value(); |
| blink::mojom::DisplayMode app_display_mode = |
| registrar.GetEffectiveDisplayModeFromManifest(app_id); |
| // Opening in non-browser-tab requires OS integration. Since os integration |
| // cannot be triggered synchronously, treat this as opening in browser. |
| if (registrar.GetInstallState(app_id) == |
| proto::INSTALLED_WITHOUT_OS_INTEGRATION && |
| app_display_mode != blink::mojom::DisplayMode::kBrowser) { |
| app_display_mode = blink::mojom::DisplayMode::kBrowser; |
| } |
| |
| LaunchHandler::ClientMode client_mode = registrar.GetAppById(app_id) |
| ->launch_handler() |
| .value_or(LaunchHandler()) |
| .client_mode; |
| if (client_mode == LaunchHandler::ClientMode::kAuto) { |
| client_mode = LaunchHandler::ClientMode::kNavigateNew; |
| } |
| // Prevent-close requires only focusing the existing tab, and never |
| // navigating. |
| if (registrar.IsPreventCloseEnabled(app_id) && |
| !registrar.IsTabbedWindowModeEnabled(app_id)) { |
| client_mode = LaunchHandler::ClientMode::kFocusExisting; |
| } |
| |
| std::optional<std::pair<Browser*, int>> existing_browser_and_tab = |
| GetAppHostForCapturing(*profile, app_id, |
| *registrar.GetAppUserDisplayMode(app_id)); |
| |
| // Focus existing. |
| if (client_mode == LaunchHandler::ClientMode::kFocusExisting) { |
| if (existing_browser_and_tab) { |
| content::WebContents* contents = |
| existing_browser_and_tab->first->tab_strip_model() |
| ->GetWebContentsAt(existing_browser_and_tab->second); |
| contents->Focus(); |
| |
| // TODO(crbug.com/359605935): Move this logic to occur later after/in |
| // CreateTargetContents in browser_navigator.cc, to ensure `contents` |
| // isn't a nullptr. |
| MaybeEnqueueLaunchParams(contents, app_id, params.url, |
| /*wait_for_navigation_to_complete=*/false); |
| |
| return std::pair(nullptr, -1); |
| } |
| |
| // Fallback to creating a new instance. |
| client_mode = LaunchHandler::ClientMode::kNavigateNew; |
| } |
| |
| // Navigate existing. |
| if (client_mode == LaunchHandler::ClientMode::kNavigateExisting) { |
| if (existing_browser_and_tab) { |
| content::WebContents* contents = |
| existing_browser_and_tab->first->tab_strip_model() |
| ->GetWebContentsAt(existing_browser_and_tab->second); |
| |
| // TODO(crbug.com/359605935): Move this logic to occur later after/in |
| // CreateTargetContents in browser_navigator.cc, to ensure `contents` |
| // isn't a nullptr. |
| MaybeEnqueueLaunchParams(contents, app_id, params.url, |
| /*wait_for_navigation_to_complete=*/true); |
| return existing_browser_and_tab; |
| } |
| client_mode = LaunchHandler::ClientMode::kNavigateNew; |
| } |
| |
| // Navigate new. |
| CHECK(client_mode == LaunchHandler::ClientMode::kNavigateNew); |
| if (app_display_mode == blink::mojom::DisplayMode::kBrowser) { |
| return std::nullopt; |
| } |
| |
| Browser* app_window = nullptr; |
| |
| if (registrar.IsTabbedWindowModeEnabled(app_id) && |
| existing_browser_and_tab) { |
| app_window = existing_browser_and_tab->first; |
| } else { |
| app_window = CreateWebAppWindowFromNavigationParams(app_id, params); |
| } |
| |
| // TODO(crbug.com/359605935): Move this logic to occur later after/in |
| // CreateTargetContents in browser_navigator.cc, to ensure `contents` |
| // isn't a nullptr. |
| MaybeEnqueueLaunchParams(params.contents_to_insert.get(), app_id, |
| params.url, |
| /*wait_for_navigation_to_complete=*/true); |
| |
| return std::pair(app_window, -1); |
| } |
| return std::nullopt; |
| } |
| |
| } // namespace web_app |