File: link_capturing_navigation_throttle.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (105 lines) | stat: -rw-r--r-- 3,885 bytes parent folder | download | duplicates (5)
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
// 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_APPS_LINK_CAPTURING_LINK_CAPTURING_NAVIGATION_THROTTLE_H_
#define CHROME_BROWSER_APPS_LINK_CAPTURING_LINK_CAPTURING_NAVIGATION_THROTTLE_H_

#include <memory>
#include <optional>

#include "base/functional/callback_forward.h"
#include "content/public/browser/navigation_throttle.h"
#include "ui/base/page_transition_types.h"
#include "url/gurl.h"

class Profile;

namespace content {
class NavigationHandle;
class WebContents;
}  // namespace content

namespace apps {

// Allows canceling a navigation to instead be routed to an installed app.
class LinkCapturingNavigationThrottle : public content::NavigationThrottle {
 public:
  using ThrottleCheckResult = content::NavigationThrottle::ThrottleCheckResult;

  static bool IsCapturableLinkNavigation(ui::PageTransition page_transition,
                                         bool allow_form_submit,
                                         bool is_in_fenced_frame_tree,
                                         bool has_user_gesture);

  // Removes |mask| bits from |page_transition|.
  static ui::PageTransition MaskOutPageTransition(
      ui::PageTransition page_transition,
      ui::PageTransition mask);

  // Inspects the WebContents of the navigation to determine whether, after
  // successful link capturing, it is a redundant dangling empty browser tab
  // that should be cleaned up. These dangling tabs result from e.g.
  // window.open(url) or target="_blank" navigations.
  static bool IsEmptyDanglingWebContentsAfterLinkCapture(
      content::NavigationHandle* handle);

  using LaunchCallback =
      base::OnceCallback<void(base::OnceClosure on_launch_complete)>;

  class Delegate {
   public:
    virtual ~Delegate();

    virtual bool ShouldCancelThrottleCreation(
        content::NavigationThrottleRegistry& registry) = 0;

    // If the return value is a nullopt, then no capture was possible.
    // Otherwise, the returned closure will launch the application at the
    // appropriate URL.
    virtual std::optional<LaunchCallback> CreateLinkCaptureLaunchClosure(
        Profile* profile,
        content::WebContents* web_contents,
        const GURL& url,
        bool is_navigation_from_link,
        int redirection_chain_size) = 0;
  };

  // Possibly creates a navigation throttle that checks if any installed apps
  // can handle the URL being navigated to.
  static bool MaybeCreateAndAdd(content::NavigationThrottleRegistry& registry,
                                std::unique_ptr<Delegate> delegate);

  using LaunchCallbackForTesting =
      base::OnceCallback<void(bool closed_web_contents)>;
  static LaunchCallbackForTesting& GetLinkCaptureLaunchCallbackForTesting();

  LinkCapturingNavigationThrottle(const LinkCapturingNavigationThrottle&) =
      delete;
  LinkCapturingNavigationThrottle& operator=(
      const LinkCapturingNavigationThrottle&) = delete;
  ~LinkCapturingNavigationThrottle() override;

  // content::NavigationHandle overrides
  const char* GetNameForLogging() override;
  ThrottleCheckResult WillStartRequest() override;
  ThrottleCheckResult WillRedirectRequest() override;

  // Visible for testing.
  static bool IsGoogleRedirectorUrl(const GURL& url);
  // Visible for testing.
  static bool ShouldOverrideUrlIfRedirected(const GURL& previous_url,
                                            const GURL& current_url);

 private:
  LinkCapturingNavigationThrottle(content::NavigationThrottleRegistry& registry,
                                  std::unique_ptr<Delegate> delegate);
  std::unique_ptr<Delegate> delegate_;
  GURL starting_url_;

  ThrottleCheckResult HandleRequest();
};

}  // namespace apps

#endif  // CHROME_BROWSER_APPS_LINK_CAPTURING_LINK_CAPTURING_NAVIGATION_THROTTLE_H_