chrome/browser/ash/url_handler.h

// Copyright 2023 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_URL_HANDLER_H_
#define CHROME_BROWSER_ASH_URL_HANDLER_H_

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

class GURL;

namespace ash {

// Whether chrome:// URLs refer to pages in Ash or pages in Lacros.
enum class ChromeSchemeSemantics {
  kLacros,
  kAsh,
};

// Tries to open the URL in a Lacros-compatible manner.
// Details are subtle and in flux. A rough summary is:
// 1) External URLs (e.g. http://) are opened in Lacros.
// 2) Internal URLs (e.g. chrome://) are opened depending on the given
//    ChromeSchemeSemantics.
//    a) kLacros: They are opened in Lacros.
//    b) kAsh: They are opened in the appropriate SWA.
//       If the URL does not belong to a SWA, but is allow-listed, it is opened
//       with a generic wrapper SWA to render in an app window.
//
// Returns false iff the URL wasn't opened and is allowed to be opened in an Ash
// browser (e.g. because Lacros is disabled).
bool TryOpenUrl(
    const GURL& url,
    WindowOpenDisposition disposition,
    NavigateParams::PathBehavior path_behavior = NavigateParams::RESPECT,
    ChromeSchemeSemantics chrome_scheme_semantics =
        ChromeSchemeSemantics::kAsh);

}  // namespace ash

#endif  // CHROME_BROWSER_ASH_URL_HANDLER_H_