Frame (JxBrowser 7.0 API)

```
public interface Frame
```
A frame in the browser.
Each web page loaded in the browser has a main (top-level) frame. The frame itself may have child frames. When a web page is unloaded, its frame and all child frames are closed automatically. Any attempt to work with an already closed frame will lead to the IllegalStateException error.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`Browser`	`browser()` Returns the `Browser` instance of this frame.
`java.util.List<Frame>`	`children()` Returns the list of child frames or an empty list if this frame does not have any children.
`java.util.Optional<Document>`	`document()` Returns an `Optional` that contains the DOM `Document` instance of the frame or an empty `Optional` if the frame does not have a document.
`boolean`	`execute(EditorCommand command)` Executes the given `command` in the frame.
`<T> T`	`executeJavaScript(java.lang.String javaScript)` Executes the given `javaScript` code in the frame and returns the result of the execution.
`void`	`executeJavaScript(java.lang.String javaScript, java.util.function.Consumer<?> callback)` Executes the given `javaScript` code in the frame and returns the result of the execution through the given `callback`.
`boolean`	`hasSelection()` Returns `true` if some content in this frame is selected.
`java.lang.String`	`html()` Returns a string that represents content of the frame in the HTML format or an empty string if the frame does not have a content or its content is empty.
`PointInspection`	`inspect(int x, int y)` Inspects the given location on the web page containing this frame and returns the result of the inspection.
`PointInspection`	`inspect(Point location)` Inspects the given `location` on the web page containing this frame and returns the result of the inspection.
`boolean`	`isCommandEnabled(EditorCommand.Name commandName)` Returns `true` if the command with the given `commandName` can be executed in the frame.
`boolean`	`isMain()` Returns `true` if the frame is a main (top-level) frame in the browser.
`void`	`loadData(LoadDataParams params)` Navigates the frame to the resource that may represent different content described by the given `params`.
`void`	`loadHtml(LoadHtmlParams params)` Navigates the frame to the resource that represents HTML document described by the given `params`.
`void`	`loadHtml(java.lang.String html)` Navigates the frame to the resource that represents HTML document with the given `html` content.
`void`	`loadUrl(java.lang.String url)` Navigates the frame to a resource identified by the given `url`.
`java.lang.String`	`name()` Returns a string that represent the name of the frame or an empty string if the frame does not have a name.
`java.util.Optional<Frame>`	`parent()` Returns an `Optional` that contains the parent `Frame` instance or an empty `Optional` if the current frame is a main (top-level) frame and it does not have a parent.
`void`	`print()` Requests printing of the currently loaded web page in this frame.
`java.lang.String`	`selectionAsHtml()` Returns a string that contains HTML of the selected content in the frame or an empty string if there is no selection.
`java.lang.String`	`selectionAsText()` Returns a text representation of the selected content in the frame or an empty string if there is no selection.

- Method Detail
  - browser
```
Browser browser()
```
    Returns the Browser instance of this frame.
  - isMain
```
boolean isMain()
```
    Returns true if the frame is a main (top-level) frame in the browser.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - parent
```
java.util.Optional<Frame> parent()
```
    Returns an Optional that contains the parent Frame instance or an empty Optional if the current frame is a main (top-level) frame and it does not have a parent.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - children
```
java.util.List<Frame> children()
```
    Returns the list of child frames or an empty list if this frame does not have any children.
    
    Throws:
    
    java.lang.IllegalStateException - when this frame is closed
  - selectionAsText
```
java.lang.String selectionAsText()
```
    Returns a text representation of the selected content in the frame or an empty string if there is no selection.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - selectionAsHtml
```
java.lang.String selectionAsHtml()
```
    Returns a string that contains HTML of the selected content in the frame or an empty string if there is no selection.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - hasSelection
```
boolean hasSelection()
```
    Returns true if some content in this frame is selected.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - document
```
java.util.Optional<Document> document()
```
    Returns an Optional that contains the DOM Document instance of the frame or an empty Optional if the frame does not have a document.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - name
```
java.lang.String name()
```
    Returns a string that represent the name of the frame or an empty string if the frame does not have a name.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - html
```
java.lang.String html()
```
    Returns a string that represents content of the frame in the HTML format or an empty string if the frame does not have a content or its content is empty.
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - loadUrl
```
void loadUrl(java.lang.String url)
```
    Navigates the frame to a resource identified by the given url. This method tells the frame 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 frame is closed
  - loadHtml
```
void loadHtml(java.lang.String html)
```
    Navigates the frame to the resource that represents HTML document with the given html content. This method tells the frame to start asynchronous loading and returns immediately.
    
    Parameters:
    
    html - a string that represents HTML content of the resource to load
    
    Throws:
    
    java.lang.IllegalArgumentException - when html is empty or blank
    
    java.lang.IllegalStateException - when the frame is closed
  - loadHtml
```
void loadHtml(LoadHtmlParams params)
```
    Navigates the frame to the resource that represents HTML document described by the given params. This method tells the frame to start asynchronous loading and returns immediately.
    
    Parameters:
    
    params - parameters such as HTML and the base URL of the document to load
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - loadData
```
void loadData(LoadDataParams params)
```
    Navigates the frame to the resource that may represent different content described by the given params. This method tells the frame to start asynchronous loading and returns immediately.
    
    Parameters:
    
    params - parameters such as content to load, its encoding, MIME type, etc
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - executeJavaScript
```
<T> T executeJavaScript(java.lang.String javaScript)
```
    Executes the given javaScript code in the frame and returns the result of the execution.
    Important: The method blocks the current thread execution and waits until the passed JavaScript code has been executed completely. The time required to complete the execution can be different depending on the passed JavaScript code. So, it is strongly recommended that the method is not invoked in the application UI thread.
    
    Type Parameters:
    
    T - one of the following types: java.lang.Boolean, java.lang.Double, java.lang.String, JsObject, EventTarget, or java.lang.Object
    
    Parameters:
    
    javaScript - a string that represents JavaScript code to execute
    
    Returns:
    
    the result of the execution. Can be null if the result of the execution on JavaScript is null or undefined
    
    Throws:
    
    java.lang.IllegalArgumentException - when javaScript is empty
  - executeJavaScript
```
void executeJavaScript(java.lang.String javaScript,
                       java.util.function.Consumer<?> callback)
```
    Executes the given javaScript code in the frame and returns the result of the execution through the given callback.
    This method does not block the current thread execution and executes the given JavaScript code asynchronously.
    
    Parameters:
    
    javaScript - a string that represents JavaScript code to execute
    
    callback - a callback you can use to get the result of the execution. The result can be one of the following types: java.lang.Boolean, java.lang.Double, java.lang.String, JsObject, EventTarget, or java.lang.Object
    
    Throws:
    
    java.lang.IllegalArgumentException - when javaScript is empty
  - execute
```
boolean execute(EditorCommand command)
```
    Executes the given command in the frame.
    Before executing the command it is recommended to check whether it can be executed or not using the #isCommandEnabled(Name) method.
    
    Parameters:
    
    command - the command to execute
    
    Returns:
    
    true if the command has been executed successfully
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
    
    See Also:
    
    #isCommandEnabled(Name)
  - isCommandEnabled
```
boolean isCommandEnabled(EditorCommand.Name commandName)
```
    Returns true if the command with the given commandName can be executed in the frame.
    Some commands can be executed only under certain conditions. For example, the EditorCommand.Name.INSERT_TEXT command can be executed only if there is a focused text field in the frame.
    
    Parameters:
    
    commandName - the name of the command to check
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - inspect
```
PointInspection inspect(Point location)
```
    Inspects the given location on the web page containing this frame and returns the result of the inspection.
    
    Parameters:
    
    location - a point on the web page
    
    Returns:
    
    the result of the inspection that contains the details about the DOM node at the given location
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - inspect
```
PointInspection inspect(int x,
                        int y)
```
    Inspects the given location on the web page containing this frame and returns the result of the inspection.
    
    Parameters:
    
    x - a horizontal coordinate on the web page
    
    y - a vertical coordinate on the web page
    
    Returns:
    
    the result of the inspection that contains the details about the DOM node at the given location
    
    Throws:
    
    java.lang.IllegalStateException - when the frame is closed
  - print
```
void print()
```
    Requests printing of the currently loaded web page in this frame.

Interface Frame

Method Summary

Method Detail

browser

isMain

parent

children

selectionAsText

selectionAsHtml

hasSelection

document

name

html

loadUrl

loadHtml

loadHtml

loadData

executeJavaScript

executeJavaScript

execute

isCommandEnabled

inspect

inspect

print