HostObjectAsyncProxyBase class
Асинхронный прокси-сервер объекта узла. Объекты узла, добавленные через CoreWebView2.AddHostObjectToScript
, предоставляются в качестве прокси-серверов объектов узла с помощью window.chrome.webview.hostObjects.{name}
. Прокси-серверы объектов узла являются обещаниями и разрешаются в объект, представляющий объект узла. Обещание отклоняется, если приложение не добавило объект с именем. Когда код JavaScript обращается к свойству или методу объекта, возвращается обещание. Обещание разрешается в значение, возвращаемое с узла для свойства или метода. Обещание отклоняется в случае ошибки; например, никакие свойства или метод объекта или параметры недопустимы.
Прокси-серверы объектов узла — это прокси-объекты JavaScript, которые перехватывают все вызовы свойств get
, свойств set
и методов. Свойства или методы, которые являются частью или Object
прототипаFunction
, выполняются в подсистеме JavaScript текущего документа. Кроме того, любое свойство или метод в массиве chrome.webview.hostObjects.options.forceLocalProperties
также выполняются в подсистеме JavaScript текущего документа. По умолчанию используется включение необязательных методов, имеющих значение в JavaScript, таких как toJSON
и Symbol.toPrimitive
. При необходимости добавьте в массив дополнительные сведения.
- Extends
Методы
apply |
Выполните вызов метода для объекта узла, соответствующего этому прокси-серверу. Все параметры преобразуются для вызова метода ведущего объекта. |
get |
Выполнение свойства |
get |
Локальное выполнение свойства |
set |
Выполнение свойства |
set |
Локальное выполнение свойства |
Сведения о методе
applyHostFunction(argArray)
Выполните вызов метода для объекта узла, соответствующего этому прокси-серверу.
Все параметры преобразуются для вызова метода ведущего объекта.
applyHostFunction(argArray?: any): Promise<any>;
Параметры
- argArray
-
any
Массив аргументов для передачи в вызов метода объекта узла.
Возвращаемое значение
Promise<any>
Обещание, представляющее преобразованное значение возвращаемого значения вызова метода объекта узла.
getHostProperty(propertyName)
Выполнение свойства get
для объекта узла. Этот метод используется для явного принудительного удаленного выполнения получения свойства, если существует конфликтующий локальный метод или свойство. Например, proxy.toString()
запускает локальный toString
метод в объекте-посреднике. Но proxy.applyHostFunction('toString') выполняет toString для объекта с прокси-сервером узла.
getHostProperty(propertyName: string): Promise<any>;
Параметры
- propertyName
-
string
Строковое имя свойства, для которого требуется получить значение.
Возвращаемое значение
Promise<any>
Обещание, представляющее преобразованное значение свойства объекта узла.
getLocalProperty(propertyName)
Локальное выполнение свойства get
в объекте-посреднике. Используйте методы для принудительного получения свойства на прокси-сервере объекта узла, а не на объекте узла, который он представляет. Например, proxy.unknownProperty
получает свойство с именем unknownProperty
из прокси-объекта узла. Но proxy.getLocalProperty('unknownProperty')
получает значение свойства unknownProperty
в объекте-посреднике.
getLocalProperty(propertyName: string): any;
Параметры
- propertyName
-
string
Имя свойства, которое требуется получить.
Возвращаемое значение
any
Значение свойства.
setHostProperty(propertyName, propertyValue)
Выполнение свойства set
для объекта узла. Этот метод используется для явного принудительного удаленного выполнения свойства set
, если существует конфликтующий локальный метод или свойство.
setHostProperty(propertyName: string, propertyValue: any): Promise<any>;
Параметры
- propertyName
-
string
Имя свойства, для которого задается значение.
- propertyValue
-
any
Значение, заданное свойству.
Возвращаемое значение
Promise<any>
Обещание, представляющее преобразованное значение свойства объекта узла. Это обещание разрешается только после изменения значения свойства.
setLocalProperty(propertyName, propertyValue)
Локальное выполнение свойства set
в объекте-посреднике. Используйте методы для принудительного задания свойства на прокси-сервере объекта узла, а не на объекте узла, который он представляет. Например, задает свойство с proxy.unknownProperty = 2
именем unknownProperty
для объекта прокси-сервера узла. Но proxy.setLocalProperty('unknownProperty', 2)
задает значение свойства unknownProperty
для объекта-посредника.
setLocalProperty(propertyName: string, propertyValue: any): any;
Параметры
- propertyName
-
string
Имя свойства, для которого задается значение.
- propertyValue
-
any
Значение, заданное свойству.
Возвращаемое значение
any
Значение свойства после его установки.