Navigation (JxBrowser 7.0 API)

All Superinterfaces:

Advisable<NavigationCallback>, Observable<NavigationEvent>
```
public interface Navigation
extends Advisable<NavigationCallback>, Observable<NavigationEvent>
```
Allows loading resources in the browser instance and working with the navigation history.

Field Summary

Fields
Modifier and Type Field and Description

static Timestamp DEFAULT_TIMEOUT_IN_SECONDS
The default timeout for resource loading is 45 seconds.

Fields
Modifier and Type	Field and Description
`static Timestamp`	`DEFAULT_TIMEOUT_IN_SECONDS` The default timeout for resource loading is 45 seconds.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`boolean`	`canGoBack()` Indicates whether the previous location can be loaded.
`boolean`	`canGoForward()` Indicates whether the next location can be loaded.
`int`	`currentEntryIndex()` Returns the index of the current item in the back-forward list or -1 if the list is empty.
`NavigationEntry`	`entryAtIndex(int index)` Returns an `Optional` that contains the `NavigationEntry` instance for the given `index` in the back-forward list, otherwise an empty `Optional`.
`int`	`entryCount()` Returns the number of items in the back-forward list.
`void`	`goBack()` Loads the previous location in the back-forward list.
`void`	`goForward()` Loads the next location in the back-forward list.
`void`	`goToIndex(int index)` Navigates to a specific location at the given `index` from the back-forward list.
`boolean`	`isLoading()` Returns `true` if a resource of a frame on the web page is being loaded.
`void`	`loadUrl(LoadUrlParams params)` Navigates to a resource identified by the given `params`.
`void`	`loadUrl(java.lang.String url)` Navigates to a resource identified by a URL.
`void`	`loadUrlAndWait(LoadUrlParams params)` Loads a resource identified by the given `params` and blocks current thread execution until the main frame of the resource is loaded completely or a timeout is reached.
`void`	`loadUrlAndWait(LoadUrlParams params, Timestamp timeout)` Loads a resource identified by the given `params` and blocks current thread execution until the main frame of the resource is loaded completely or the given `timeoutInSeconds` is reached.
`void`	`loadUrlAndWait(java.lang.String url)` Loads a resource identified by the given `url` and blocks current thread execution until the main frame of the resource is loaded completely or a timeout is reached.
`void`	`loadUrlAndWait(java.lang.String url, Timestamp timeout)` Loads a resource identified by the given `url` and blocks current thread execution until the main frame of the resource is loaded completely or the given `timeoutInSeconds` is reached.
`void`	`reload()` Reloads the currently loaded web page.
`void`	`reloadAndCheckForRepost()` Reloads the currently loaded web page, but if the current web page has POST data, the user is prompted to see if they really want to reload the page.
`void`	`reloadIgnoringCache()` Reloads the currently loaded web page ignoring caches.
`void`	`reloadIgnoringCacheAndCheckForRepost()` Reloads the currently loaded web page ignoring caches, but if the current web page has POST data, the user is prompted to see if they really want to reload the page.
`boolean`	`removeEntryAtIndex(int index)` Removes the item at the given `index` in the back-forward list and returns `true` if it was removed successfully.
`void`	`stop()` Cancels any pending navigation or download operation and stops any dynamic page elements, such as background sounds and animations.

Methods inherited from interface com.teamdev.jxbrowser.callback.Advisable
get, remove, set

Methods inherited from interface com.teamdev.jxbrowser.event.Observable
on

- Field Detail
  - DEFAULT_TIMEOUT_IN_SECONDS
```
static final Timestamp DEFAULT_TIMEOUT_IN_SECONDS
```
    The default timeout for resource loading is 45 seconds.
- Method Detail
  - loadUrl
```
void loadUrl(java.lang.String url)
```
    Navigates to a resource identified by a URL. This method tells the browser to start asynchronous loading and returns immediately.
    
    Parameters:
    
    url - URL of the resource to load
    
    Throws:
    
    java.lang.IllegalArgumentException - when url is empty or blank
    
    java.lang.IllegalStateException - when the browser is already closed
  - loadUrlAndWait
```
void loadUrlAndWait(java.lang.String url)
```
    Loads a resource identified by the given url and blocks current thread execution until the main frame of the resource is loaded completely or a timeout is reached.
    
    Parameters:
    
    url - URL of the resource to load
    
    Throws:
    
    java.lang.IllegalArgumentException - when url is empty or blank
    
    TimeoutException - when the resource hasn't been loaded within a default timeout
    
    NavigationException - when navigation failed
    
    java.lang.IllegalStateException - when the browser is already closed
  - loadUrlAndWait
```
void loadUrlAndWait(java.lang.String url,
                    Timestamp timeout)
```
    Loads a resource identified by the given url and blocks current thread execution until the main frame of the resource is loaded completely or the given timeoutInSeconds is reached.
    
    Parameters:
    
    url - URL of the resource to load
    
    timeout - a timeout in seconds
    
    Throws:
    
    java.lang.IllegalArgumentException - when url is empty or blank
    
    java.lang.IllegalArgumentException - when timeoutInSeconds is 0 or negative
    
    TimeoutException - when the resource hasn't been loaded within a timeout
    
    NavigationException - when navigation failed
    
    java.lang.IllegalStateException - when the browser is already closed
  - loadUrl
```
void loadUrl(LoadUrlParams params)
```
    Navigates to a resource identified by the given params. This method tells the browser to start asynchronous loading and returns immediately.
    
    Parameters:
    
    params - parameters such as URL, POST data, and HTTP headers
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - loadUrlAndWait
```
void loadUrlAndWait(LoadUrlParams params)
```
    Loads a resource identified by the given params and blocks current thread execution until the main frame of the resource is loaded completely or a timeout is reached.
    
    Parameters:
    
    params - parameters such as URL, POST data, and HTTP headers
    
    Throws:
    
    TimeoutException - when the resource hasn't been loaded within a default timeout
    
    NavigationException - when navigation failed
    
    java.lang.IllegalStateException - when the browser is already closed
  - loadUrlAndWait
```
void loadUrlAndWait(LoadUrlParams params,
                    Timestamp timeout)
```
    Loads a resource identified by the given params and blocks current thread execution until the main frame of the resource is loaded completely or the given timeoutInSeconds is reached.
    
    Parameters:
    
    params - parameters such as URL, POST data and HTTP headers
    
    timeout - a timeout in seconds
    
    Throws:
    
    java.lang.IllegalArgumentException - when timeoutInSeconds is 0 or negative
    
    TimeoutException - when the resource hasn't been loaded within a timeout
    
    NavigationException - when navigation failed
    
    java.lang.IllegalStateException - when the browser is already closed
  - isLoading
```
boolean isLoading()
```
    Returns true if a resource of a frame on the web page is being loaded.
  - goBack
```
void goBack()
```
    Loads the previous location in the back-forward list. It does nothing if there is no previous location in the list.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - canGoBack
```
boolean canGoBack()
```
    Indicates whether the previous location can be loaded.
    
    Returns:
    
    true if the previous location in the back-forward list can be loaded
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - goForward
```
void goForward()
```
    Loads the next location in the back-forward list. It does nothing if there is no next location in the list.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - canGoForward
```
boolean canGoForward()
```
    Indicates whether the next location can be loaded.
    
    Returns:
    
    true if the next location in the back-forward list can be loaded
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - stop
```
void stop()
```
    Cancels any pending navigation or download operation and stops any dynamic page elements, such as background sounds and animations.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - reload
```
void reload()
```
    Reloads the currently loaded web page.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - reloadAndCheckForRepost
```
void reloadAndCheckForRepost()
```
    Reloads the currently loaded web page, but if the current web page has POST data, the user is prompted to see if they really want to reload the page.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
    
    See Also:
    
    BeforeFormRepostCallback
  - reloadIgnoringCache
```
void reloadIgnoringCache()
```
    Reloads the currently loaded web page ignoring caches.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - reloadIgnoringCacheAndCheckForRepost
```
void reloadIgnoringCacheAndCheckForRepost()
```
    Reloads the currently loaded web page ignoring caches, but if the current web page has POST data, the user is prompted to see if they really want to reload the page.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
    
    See Also:
    
    BeforeFormRepostCallback
  - goToIndex
```
void goToIndex(int index)
```
    Navigates to a specific location at the given index from the back-forward list.
    
    Parameters:
    
    index - location of the item in the back-forward list
    
    Throws:
    
    java.lang.IllegalArgumentException - when index is less than 0
    
    java.lang.IllegalArgumentException - when index is more than the number of items in the back-forward list
    
    java.lang.IllegalStateException - when the browser is already closed
    
    See Also:
    
    entryCount()
  - entryCount
```
int entryCount()
```
    Returns the number of items in the back-forward list.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - currentEntryIndex
```
int currentEntryIndex()
```
    Returns the index of the current item in the back-forward list or -1 if the list is empty.
    
    Throws:
    
    java.lang.IllegalStateException - when the browser is already closed
  - entryAtIndex
```
NavigationEntry entryAtIndex(int index)
```
    Returns an Optional that contains the NavigationEntry instance for the given index in the back-forward list, otherwise an empty Optional.
    
    Parameters:
    
    index - location of the item to return in the back-forward list
    
    Throws:
    
    java.lang.IllegalArgumentException - when index is less than 0
    
    java.lang.IllegalArgumentException - when index is more than the number of items in the back-forward list
    
    java.lang.IllegalStateException - when the browser is already closed
  - removeEntryAtIndex
```
boolean removeEntryAtIndex(int index)
```
    Removes the item at the given index in the back-forward list and returns true if it was removed successfully.
    
    Parameters:
    
    index - location of the item to remove in the back-forward list
    
    Returns:
    
    true if the item was removed successfully
    
    Throws:
    
    java.lang.IllegalArgumentException - when index is less than 0
    
    java.lang.IllegalArgumentException - when index points to the current item in the back-forward list
    
    java.lang.IllegalArgumentException - when index is more than the number of items in the back-forward list
    
    java.lang.IllegalStateException - when the browser is already closed

Interface Navigation

Field Summary

Method Summary

Methods inherited from interface com.teamdev.jxbrowser.callback.Advisable

Methods inherited from interface com.teamdev.jxbrowser.event.Observable

Field Detail

DEFAULT_TIMEOUT_IN_SECONDS

Method Detail

loadUrl

loadUrlAndWait

loadUrlAndWait

loadUrl

loadUrlAndWait

loadUrlAndWait

isLoading

goBack

canGoBack

goForward

canGoForward

stop

reload

reloadAndCheckForRepost

reloadIgnoringCache

reloadIgnoringCacheAndCheckForRepost

goToIndex

entryCount

currentEntryIndex

entryAtIndex

removeEntryAtIndex