chromium/chrome/browser/ui/singleton_tabs.h

// Copyright 2012 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_UI_SINGLETON_TABS_H_
#define CHROME_BROWSER_UI_SINGLETON_TABS_H_

#include "chrome/browser/ui/browser_navigator_params.h"

class Browser;
class GURL;

// Methods for opening "singleton tabs". Tabs are guaranteed unique by varying
// metrics within a particular Browser window.

// Core singleton tab API:

// Shows a given a URL. If a tab with the same URL (ignoring the ref) is already
// visible in this browser, it becomes selected. Otherwise a new tab is created.
// Note: On Ash, if Lacros is enabled, this requests the URL to be opened in a
// Lacros-compatible manner (typically: in Lacros).
void ShowSingletonTab(Browser* browser, const GURL& url);

// Like above, but uses the last active tabbed browser or creates a new one if
// possible.
void ShowSingletonTab(Profile* profile, const GURL& url);

// Like ShowSingletonTab, but if the current tab is the new tab page or
// about:blank, then overwrite it with the passed contents.
void ShowSingletonTabOverwritingNTP(
    Profile* profile,
    const GURL& url,
    NavigateParams::PathBehavior path_behavior = NavigateParams::RESPECT);
void ShowSingletonTabOverwritingNTP(
    Browser* browser,
    const GURL& url,
    NavigateParams::PathBehavior path_behavior = NavigateParams::RESPECT);
// This overload (on Ash) is incompatible with Lacros. Do not use it in new Ash
// code.
void ShowSingletonTabOverwritingNTP(NavigateParams* params);

// Creates a NavigateParams struct for a singleton tab navigation.
NavigateParams GetSingletonTabNavigateParams(Browser* browser, const GURL& url);

// If the given navigational URL is already open in |browser|, return
// the tab and tab index for it. Otherwise, returns -1.
int GetIndexOfExistingTab(Browser* browser, const NavigateParams& params);

// This simply calls GetIndexOfExistingTab() for each browser that
// matches the passed |profile|, and returns the first found tab.
std::pair<Browser*, int> GetIndexAndBrowserOfExistingTab(
    Profile* profile,
    const NavigateParams& params);

#endif  // CHROME_BROWSER_UI_SINGLETON_TABS_H_