1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef CONTENT_PUBLIC_BROWSER_NAVIGATION_TYPE_H_ 6 #define CONTENT_PUBLIC_BROWSER_NAVIGATION_TYPE_H_ 7 8 namespace content { 9 10 // Indicates different types of navigations that can occur that we will handle 11 // separately. 12 enum NavigationType { 13 // Unknown type. 14 NAVIGATION_TYPE_UNKNOWN, 15 16 // A new page was navigated in the main frame. 17 NAVIGATION_TYPE_NEW_PAGE, 18 19 // Renavigating to an existing navigation entry. The entry is guaranteed to 20 // exist in the list, or else it would be a new page or IGNORE navigation. 21 NAVIGATION_TYPE_EXISTING_PAGE, 22 23 // The same page has been reloaded as a result of the user requesting 24 // navigation to that same page (like pressing Enter in the URL bar). This 25 // is not the same as an in-page navigation because we'll actually have a 26 // pending entry for the load, which is then meaningless. 27 NAVIGATION_TYPE_SAME_PAGE, 28 29 // In page navigations are when the reference fragment changes. This will 30 // be in the main frame only (we won't even get notified of in-page 31 // subframe navigations). It may be for any page, not necessarily the last 32 // committed one (for example, whey going back to a page with a ref). 33 NAVIGATION_TYPE_IN_PAGE, 34 35 // A new subframe was manually navigated by the user. We will create a new 36 // NavigationEntry so they can go back to the previous subframe content 37 // using the back button. 38 NAVIGATION_TYPE_NEW_SUBFRAME, 39 40 // A subframe in the page was automatically loaded or navigated to such that 41 // a new navigation entry should not be created. There are two cases: 42 // 1. Stuff like iframes containing ads that the page loads automatically. 43 // The user doesn't want to see these, so we just update the existing 44 // navigation entry. 45 // 2. Going back/forward to previous subframe navigations. We don't create 46 // a new entry here either, just update the last committed entry. 47 // These two cases are actually pretty different, they just happen to 48 // require almost the same code to handle. 49 NAVIGATION_TYPE_AUTO_SUBFRAME, 50 51 // Nothing happened. This happens when we get information about a page we 52 // don't know anything about. It can also happen when an iframe in a popup 53 // navigated to about:blank is navigated. Nothing needs to be done. 54 NAVIGATION_TYPE_NAV_IGNORE, 55 }; 56 57 } // namespace content 58 59 #endif // CONTENT_PUBLIC_BROWSER_NAVIGATION_TYPE_H_ 60