Класс JSObject

public abstract class JSObject
extends Object

Позволяет коду Java взаимодействовать с объектами JavaScript.

Когда объект JavaScript передаётся или возвращается коду Java, он оборачивается в экземпляр JSObject. Когда экземпляр JSObject передаётся в движок JavaScript, он распаковывается обратно в исходный объект JavaScript. Класс JSObject предоставляет способ вызова методов JavaScript и проверки свойств JavaScript.

Любые данные, возвращаемые из движка JavaScript в Java, преобразуются в типы данных Java. Некоторые данные, передаваемые в движок JavaScript, преобразуются в типы данных JavaScript.

Конструкторы

МодификаторКонструкторОписание
protected JSObject()

Создаёт новый объект JSObject.

Методы

Модификатор и типМетодОписание
abstract Objectcall​(String methodName, Object... args)

Вызывает метод JavaScript.

abstract Objecteval​(String s)

Вычисляет выражение JavaScript.

abstract ObjectgetMember​(String name)

Возвращает именованный член объекта JavaScript.

abstract ObjectgetSlot​(int index)

Возвращает индексированный член объекта JavaScript.

static JSObjectgetWindow​(Applet applet)

Устарело.

API апплетов устарело.

abstract voidremoveMember​(String name)

Удаляет именованный член объекта JavaScript.

abstract voidsetMember​(String name, Object value)

Устанавливает именованный член объекта JavaScript.

abstract voidsetSlot​(int index, Object value)

Устанавливает индексированный член объекта JavaScript.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

JSObject

protected JSObject()

Создаёт новый объект JSObject. Пользователи не должны вызывать этот метод и не должны наследовать от JSObject.

Методы

call

public abstract Object call(String methodName,
                            Object... args)
                     throws JSException

Вызывает метод JavaScript. Эквивалентно "this.methodName(args[0], args[1], ...)" в JavaScript.

Параметры:
methodName - Название вызываемого метода JavaScript.
args - объекты Java, переданные в качестве аргументов методу.
Возвращает:
Результат метода.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

eval

public abstract Object eval(String s)
                     throws JSException

Вычисляет выражение JavaScript. Выражение — это строка исходного кода JavaScript, которая будет вычислена в контексте, заданном параметром «this».

Параметры:
s - Выражение JavaScript.
Возвращает:
Результат вычисления JavaScript.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

getMember

public abstract Object getMember(String name)
                          throws JSException

Возвращает именованный член объекта JavaScript. Эквивалентно "this.name" в JavaScript.

Параметры:
name - Имя свойства JavaScript, к которому необходимо получить доступ.
Возвращает:
Значение свойства.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

setMember

public abstract void setMember(String name,
                               Object value)
                        throws JSException

Устанавливает именованный член объекта JavaScript. Эквивалентно "this.name = value" в JavaScript.

Параметры:
name - Имя свойства JavaScript, к которому необходимо получить доступ.
value - Значение свойства.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

removeMember

public abstract void removeMember(String name)
                           throws JSException

Удаляет именованный член объекта JavaScript. Эквивалентно "delete this.name" в JavaScript.

Параметры:
name - Имя свойства JavaScript, которое необходимо удалить.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

getSlot

public abstract Object getSlot(int index)
                        throws JSException

Возвращает индексированный член объекта JavaScript. Эквивалентно "this[index]" в JavaScript.

Параметры:
index - Индекс массива, к которому необходимо получить доступ.
Возвращает:
Значение индексированного члена.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

setSlot

public abstract void setSlot(int index,
                             Object value)
                      throws JSException

Устанавливает индексированный член объекта JavaScript. Эквивалентно "this[index] = value" в JavaScript.

Параметры:
index - Индекс массива, к которому необходимо получить доступ.
value - Значение для установки
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript.

getWindow

@Deprecated(since="9")
public static JSObject getWindow(Applet applet)
                          throws JSException
Устарело.
API апплетов устарело. Смотрите документацию пакета java.applet для получения дополнительной информации.

Возвращает объект JSObject для окна, содержащего данный апплет. Этот метод работает только в том случае, если код Java выполняется в браузере в виде апплета. Возвращённый объект может использоваться для прямого доступа к HTML DOM.

Параметры:
applet - Апплет.
Возвращает:
Объект JSObject, представляющий окно, содержащее данный апплет, или null если мы не подключены к браузеру.
Исключения:
JSException - при сообщении об ошибке из браузера или движка JavaScript или если апплет null

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/jdk.jsobject/netscape/javascript/JSObject.html

Spec-Zone .ru
спецификации, руководства, описания, API