1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126
|
// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_ASH_BROWSER_DELEGATE_BROWSER_CONTROLLER_H_
#define CHROME_BROWSER_ASH_BROWSER_DELEGATE_BROWSER_CONTROLLER_H_
#include <string_view>
#include "base/containers/span.h"
#include "base/observer_list_types.h"
#include "chrome/browser/ash/browser_delegate/browser_type.h"
#include "components/webapps/common/web_app_id.h"
#include "url/gurl.h"
class Browser;
namespace content {
class WebContents;
} // namespace content
namespace user_manager {
class User;
} // namespace user_manager
namespace ash {
class BrowserDelegate;
// BrowserController is a singleton created by
// ChromeBrowserMainExtraPartsAsh::PostProfileInit. See also README.md.
class BrowserController {
public:
// See AddObserver below.
class Observer : public base::CheckedObserver {
public:
// Called when the last browser is irrevocably being closed.
// TODO(crbug.com/369689187): Figure out if/how we want to allow inspection
// of the browser (the instance still exists but we shouldn't allow
// arbitrary operations).
virtual void OnLastBrowserClosed() {}
};
// See CreateWebApp below.
struct CreateParams {
bool allow_resize;
bool allow_maximize;
bool allow_fullscreen;
// TODO(crbug.com/369689187): Figure out if the restore_id field makes
// sense, and if so, add a description.
int32_t restore_id;
};
static BrowserController* GetInstance();
// Returns the corresponding delegate, possibly creating it first.
// Returns nullptr for a nullptr input.
// NOTE: This function is here only temporarily to facilitate transitioning
// code from Browser to BrowserDelegate incrementally. See also
// BrowserDelegate::GetBrowser.
virtual BrowserDelegate* GetDelegate(Browser* browser) = 0;
// Returns (the delegate for) the most recently used browser that still
// exists. Returns nullptr if there's none.
virtual BrowserDelegate* GetLastUsedBrowser() = 0;
// Returns (the delegate for) the most recently used browser that is
// currently visible. Returns nullptr if there's none.
virtual BrowserDelegate* GetLastUsedVisibleBrowser() = 0;
// Returns (the delegate for) the most recently used browser that is
// currently visible and on-the-record. Returns nullptr if there's none.
virtual BrowserDelegate* GetLastUsedVisibleOnTheRecordBrowser() = 0;
// Returns (the delegate for) the most recently activated web app browser
// that matches the given parameters. Returns nullptr if there's none.
// Url matching is done ignoring any references, and only if `url` is not
// empty.
// The `browser_type` must be kApp or kAppPopup.
virtual BrowserDelegate* FindWebApp(const user_manager::User& user,
webapps::AppId app_id,
BrowserType browser_type,
const GURL& url = GURL()) = 0;
// Makes a POST request in a new tab in the last active tabbed browser. If no
// such browser exists, a new one is created. Returns nullptr if the creation
// is not possible for the given arguments.
// This is needed by the Media app.
virtual BrowserDelegate* NewTabWithPostData(
const user_manager::User& user,
const GURL& url,
base::span<const uint8_t> post_data,
std::string_view extra_headers) = 0;
// Creates a web app browser for the given parameters.
// The `browser_type` must be kApp or kAppPopup. In the case of kApp, a pinned
// home tab is added if that feature is supported and a URL is registered for
// the app.
// Returns nullptr if the creation is not possible for the given arguments.
virtual BrowserDelegate* CreateWebApp(const user_manager::User& user,
webapps::AppId app_id,
BrowserType browser_type,
const CreateParams& params) = 0;
// Creates a "custom tab" browser with the given contents.
// TODO(crbug.com/369689187): This is a special kind of popup only used by
// ARC. It's based on the Browser::TYPE_CUSTOM_TAB type that only exists on
// ChromeOS. Consider getting rid of this special type.
virtual BrowserDelegate* CreateCustomTab(
const user_manager::User& user,
std::unique_ptr<content::WebContents> contents) = 0;
// Facilitates observation of browser events.
virtual void AddObserver(Observer* observer) = 0;
virtual void RemoveObserver(Observer* observer) = 0;
protected:
BrowserController();
BrowserController(const BrowserController&) = delete;
BrowserController& operator=(const BrowserController&) = delete;
virtual ~BrowserController();
};
} // namespace ash
#endif // CHROME_BROWSER_ASH_BROWSER_DELEGATE_BROWSER_CONTROLLER_H_
|