Класс JSObject
- java.lang.Object
- netscape.javascript.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 Object | call(String methodName,
Object... args) | Вызывает метод JavaScript. |
abstract Object | eval(String s) | Вычисляет выражение JavaScript. |
abstract Object | getMember(String name) | Возвращает именованный член объекта JavaScript. |
abstract Object | getSlot(int index) | Возвращает индексированный член объекта JavaScript. |
static JSObject | getWindow(Applet applet) | Устарело. API апплетов устарело. |
abstract void | removeMember(String name) | Удаляет именованный член объекта JavaScript. |
abstract void | setMember(String name,
Object value) | Устанавливает именованный член объекта JavaScript. |
abstract void | setSlot(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Возвращает объект 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