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
127
128
129
130
131
132
133
134
135
136
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_EXTENSIONS_API_WEB_NAVIGATION_FRAME_NAVIGATION_STATE_H_
#define CHROME_BROWSER_EXTENSIONS_API_WEB_NAVIGATION_FRAME_NAVIGATION_STATE_H_
#include <map>
#include <set>
#include "base/compiler_specific.h"
#include "googleurl/src/gurl.h"
namespace extensions {
// Tracks the navigation state of all frames in a given tab currently known to
// the webNavigation API. It is mainly used to track in which frames an error
// occurred so no further events for this frame are being sent.
class FrameNavigationState {
public:
// A frame is uniquely identified by its frame ID and the render process ID.
// We use the render process ID instead of e.g. a pointer to the RVH so we
// don't depend on the lifetime of the RVH.
struct FrameID {
FrameID();
FrameID(int64 frame_num, int render_process_id);
~FrameID();
bool operator<(const FrameID& other) const;
bool operator==(const FrameID& other) const;
bool operator!=(const FrameID& other) const;
int64 frame_num;
int render_process_id;
};
typedef std::set<FrameID>::const_iterator const_iterator;
static FrameID kInvalidFrameID;
FrameNavigationState();
~FrameNavigationState();
// Use these to iterate over all frame IDs known by this object.
const_iterator begin() const { return frame_ids_.begin(); }
const_iterator end() const { return frame_ids_.end(); }
// True if navigation events for the given frame can be sent.
bool CanSendEvents(FrameID frame_id) const;
// True if in general webNavigation events may be sent for the given URL.
bool IsValidUrl(const GURL& url) const;
// Starts to track a frame identified by its |frame_id| showing the URL |url|.
void TrackFrame(FrameID frame_id,
const GURL& url,
bool is_main_frame,
bool is_error_page);
// Update the URL associated with a given frame.
void UpdateFrame(FrameID frame_id, const GURL& url);
// Returns true if |frame_id| is a known frame.
bool IsValidFrame(FrameID frame_id) const;
// Returns the URL corresponding to a tracked frame given by its |frame_id|.
GURL GetUrl(FrameID frame_id) const;
// True if the frame given by its |frame_id| is the main frame of its tab.
bool IsMainFrame(FrameID frame_id) const;
// Returns the frame ID of the main frame, or -1 if the frame ID is not
// known.
FrameID GetMainFrameID() const;
// Marks a frame as in an error state, i.e. the onErrorOccurred event was
// fired for this frame, and no further events should be sent for it.
void SetErrorOccurredInFrame(FrameID frame_id);
// True if the frame is marked as being in an error state.
bool GetErrorOccurredInFrame(FrameID frame_id) const;
// Marks a frame as having finished its last navigation, i.e. the onCompleted
// event was fired for this frame.
void SetNavigationCompleted(FrameID frame_id);
// True if the frame is currently not navigating.
bool GetNavigationCompleted(FrameID frame_id) const;
// Marks a frame as having committed its navigation, i.e. the onCommitted
// event was fired for this frame.
void SetNavigationCommitted(FrameID frame_id);
// True if the frame has committed its navigation.
bool GetNavigationCommitted(FrameID frame_id) const;
// Marks a frame as redirected by the server.
void SetIsServerRedirected(FrameID frame_id);
// True if the frame was redirected by the server.
bool GetIsServerRedirected(FrameID frame_id) const;
#ifdef UNIT_TEST
static void set_allow_extension_scheme(bool allow_extension_scheme) {
allow_extension_scheme_ = allow_extension_scheme;
}
#endif
private:
struct FrameState {
bool error_occurred; // True if an error has occurred in this frame.
bool is_main_frame; // True if this is a main frame.
bool is_navigating; // True if there is a navigation going on.
bool is_committed; // True if the navigation is already committed.
bool is_server_redirected; // True if a server redirect happened.
GURL url; // URL of this frame.
};
typedef std::map<FrameID, FrameState> FrameIdToStateMap;
// Tracks the state of known frames.
FrameIdToStateMap frame_state_map_;
// Set of all known frames.
std::set<FrameID> frame_ids_;
// The current main frame.
FrameID main_frame_id_;
// If true, also allow events from chrome-extension:// URLs.
static bool allow_extension_scheme_;
DISALLOW_COPY_AND_ASSIGN(FrameNavigationState);
};
} // namespace extensions
#endif // CHROME_BROWSER_EXTENSIONS_API_WEB_NAVIGATION_FRAME_NAVIGATION_STATE_H_
|
