JSContext (JxBrowser 6.23.1 API)

java.lang.Object
- com.teamdev.jxbrowser.chromium.JSContext

```
public class JSContext
extends java.lang.Object
```
Represents JavaScript execution context. Each frame on the web page has it's own execution context. JavaScript objects created in one context will not be visible and accessible in other contexts.
JavaScript context is initialized and created automatically for each frame on the loaded web page only if this frame has JavaScript code. If frame doesn't have JavaScript code, context will not be created for this frame. To force context creation you can call Browser.executeJavaScriptAndReturnValue(long, String) method for required frame.
When frame is reloaded or another web page is loaded, all existing contexts will be destroyed and new contexts will be created. To check whether context is destroyed call the isDisposed() method or use DisposeListener.
表示JavaScript执行上下文。网页上的每个框架都有其自己的执行上下文。在一个上下文中创建的JavaScript对象在其他上下文中将不可见和不可访问。仅当此框架具有JavaScript代码时，才会为加载的网页上的每个框架自动初始化并创建JavaScript上下文。如果框架没有JavaScript代码，则不会为此框架创建上下文。要强制创建上下文，可以为所需框架调用Browser.executeJavaScriptAndReturnValue（long，String）方法。当重新加载框架或加载另一个网页时，所有现有上下文将被销毁并创建新的上下文。要检查上下文是否被破坏，请调用isDisposed（）方法或使用DisposeListener。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addDisposeListener(DisposeListener<JSContext> listener)` Adds the specified dispose listener to receive dispose events from this context instance. 添加指定的Dispose侦听器以从此上下文实例接收Dispose事件。
`JSObject`	`createObject()` Create a new empty JavaScript object instance that is available in scope of the current execution context. 创建一个新的空JavaScript对象实例，该实例在当前执行上下文的范围内可用。
`boolean`	`equals(java.lang.Object o)`
`java.util.List<DisposeListener<JSContext>>`	`getDisposeListeners()` Returns a list of all the dispose listeners registered on this context. 返回在此上下文中注册的所有处置侦听器的列表。
`long`	`getFrameId()` Returns unique identifier of a frame which is associated this this JavaScript execution context. 返回与此JavaScript执行上下文相关联的框架的唯一标识符。
`long`	`getWorldId()` Returns JavaScript world identifier associated with the current context. 返回与当前上下文关联的JavaScript世界标识符。
`int`	`hashCode()`
`boolean`	`isDisposed()` Indicates whether context is disposed or not. 指示是否处置上下文。
`void`	`removeDisposeListener(DisposeListener<JSContext> listener)` Removes the specified dispose listener so that it no longer receives context dispose events from this instance. 移除指定的Dispose侦听器，以使其不再从该实例接收上下文Dispose事件。

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getFrameId
```
public long getFrameId()
```
    Returns unique identifier of a frame which is associated this this JavaScript execution context. This method returns valid identifier even when context is disposed and frame with this ID doesn't exist anymore. Use this method only in combination with the isDisposed() method.
    返回与此JavaScript执行上下文相关联的框架的唯一标识符。即使放置了上下文并且具有该ID的帧不再存在，此方法也会返回有效的标识符。仅将此方法与isDisposed（）方法结合使用。
    
    Returns:
    
    unique identifier of a frame which is associated this this JavaScript execution context. 与该JavaScript执行上下文相关联的框架的唯一标识符。
  - getWorldId
```
public long getWorldId()
```
    Returns JavaScript world identifier associated with the current context.
    返回与当前上下文关联的JavaScript世界标识符。
    
    Returns:
    
    JavaScript world identifier associated with the current context. 与当前上下文关联的JavaScript世界标识符。
  - createObject
```
public JSObject createObject()
```
    Create a new empty JavaScript object instance that is available in scope of the current execution context.
    创建一个新的空JavaScript对象实例，该实例在当前执行上下文的范围内可用。
    
    Returns:
    
    a new empty JavaScript object instance that is available in scope of the current execution context. 在当前执行上下文范围内可用的新的空JavaScript对象实例。
    
    Throws:
    
    java.lang.IllegalStateException - when context is not valid anymore and disposed.
  - isDisposed
```
public boolean isDisposed()
```
    Indicates whether context is disposed or not. JavaScript context is disposed automatically when its frame is being unloaded. All JavaScript objects associated with this context will be disposed automatically.
    指示是否处置上下文。当JavaScript上下文的框架被卸载时，它会自动处置。与该上下文关联的所有JavaScript对象将被自动处置。
    
    Returns:
    
    true when context is disposed, otherwise - false. 处理上下文时，否则-。
  - addDisposeListener
```
public void addDisposeListener(DisposeListener<JSContext> listener)
```
    Adds the specified dispose listener to receive dispose events from this context instance. If listener listener is null, no exception is thrown and no action is performed.
    添加指定的Dispose侦听器以从此上下文实例接收Dispose事件。如果listener listener为null，则不会引发任何异常并且不执行任何操作。
    
    Parameters:
    
    listener - the context dispose listener. -上下文配置侦听器。
  - removeDisposeListener
```
public void removeDisposeListener(DisposeListener<JSContext> listener)
```
    Removes the specified dispose listener so that it no longer receives context dispose events from this instance.
    移除指定的Dispose侦听器，以使其不再从该实例接收上下文Dispose事件。
    
    Parameters:
    
    listener - the context dispose listener to remove. -上下文将侦听器删除。
  - getDisposeListeners
```
public java.util.List<DisposeListener<JSContext>> getDisposeListeners()
```
    Returns a list of all the dispose listeners registered on this context.
    返回在此上下文中注册的所有处置侦听器的列表。
    
    Returns:
    
    all of this context's DisposeListeners or an empty list if no dispose listeners are currently registered. 所有此上下文的；如果当前未注册任何处置侦听器，则返回一个空列表。
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object

Class JSContext

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getFrameId

getWorldId

createObject

isDisposed

addDisposeListener

removeDisposeListener

getDisposeListeners

equals

hashCode