HostObjectSyncProxy class

Пакет:

WebView2Script

Прокси-сервер объекта синхронного узла. Объекты узла, добавленные через CoreWebView2.AddHostObjectToScript , предоставляются в качестве прокси-серверов объектов узла с помощью window.chrome.webview.hostObjects.{name}. Прокси-сервер объекта узла представляет объект узла.

Прокси-серверы объектов узла — это прокси-объекты JavaScript, которые перехватывают все вызовы свойств get, свойств setи методов. Свойства или методы, которые являются частью или Object прототипаFunction, выполняются локально. Кроме того, любое свойство или метод в массиве chrome.webview.hostObjects.options.forceLocalProperties также выполняется локально. По умолчанию используется включение необязательных методов, имеющих значение в JavaScript, таких как toJSON и Symbol.toPrimitive. При необходимости добавьте в массив дополнительные сведения.

Extends

Function

Методы

applyHostFunction(argArray)	Выполните вызов метода для объекта узла, соответствующего этому прокси-серверу. Все параметры преобразуются для вызова метода ведущего объекта.
async()	Метод, который блокирует и возвращает асинхронный прокси-сервер объекта узла для того же объекта узла. Например, chrome.webview.hostObjects.sync.sample.methodCall() возвращает прокси-сервер объекта синхронного узла. Выполнение метода в async этом блокируется, а затем возвращает асинхронный прокси-сервер объекта узла для того же объекта узла: const asyncProxy = chrome.webview.hostObjects.sync.sample.methodCall().async().
getHostProperty(propertyName)	Выполнение свойства get для объекта узла. Этот метод используется для явного принудительного удаленного выполнения свойства get , если существует конфликтующий локальный метод или свойство. Например, proxy.toString() запускает локальный toString метод в объекте-посреднике. Но proxy.applyHostFunction('toString') вместо этого выполняется toString в объекте прокси-сервера узла.
getLocalProperty(propertyName)	Локальное выполнение свойства get в объекте-посреднике. Используйте методы для принудительного получения свойства на прокси-сервере объекта узла, а не на объекте узла, который он представляет. Например, proxy.unknownProperty получает свойство с именем unknownProperty из прокси-объекта узла. Но proxy.getLocalProperty('unknownProperty') получает значение свойства unknownProperty в объекте-посреднике.
setHostProperty(propertyName, propertyValue)	Выполнение свойства set для объекта узла. Этот метод используется для явного принудительного удаленного выполнения свойства set , если существует конфликтующий локальный метод или свойство.
setLocalProperty(propertyName, propertyValue)	Локальное выполнение свойства set в объекте-посреднике. Используйте методы для принудительного задания свойства на прокси-сервере объекта узла, а не на объекте узла, который он представляет. Например, задает свойство с proxy.unknownProperty = 2 именем unknownProperty для объекта прокси-сервера узла. Но proxy.setLocalProperty('unknownProperty', 2) задает значение свойства unknownProperty для объекта-посредника.

Сведения о методе

applyHostFunction(argArray)

Выполните вызов метода для объекта узла, соответствующего этому прокси-серверу.

Все параметры преобразуются для вызова метода ведущего объекта.

applyHostFunction(argArray?: any): any;

Параметры

argArray

any

Массив аргументов для передачи в вызов метода объекта узла.

Возвращаемое значение

any

Преобразованное значение возвращаемого значения вызова метода объекта узла.

async()

Метод, который блокирует и возвращает асинхронный прокси-сервер объекта узла для того же объекта узла. Например, chrome.webview.hostObjects.sync.sample.methodCall() возвращает прокси-сервер объекта синхронного узла. Выполнение метода в async этом блокируется, а затем возвращает асинхронный прокси-сервер объекта узла для того же объекта узла: const asyncProxy = chrome.webview.hostObjects.sync.sample.methodCall().async().

async(): HostObjectAsyncProxy;

Возвращаемое значение

HostObjectAsyncProxy

Асинхронный прокси-сервер объекта узла для того же объекта узла.

getHostProperty(propertyName)

Выполнение свойства get для объекта узла. Этот метод используется для явного принудительного удаленного выполнения свойства get , если существует конфликтующий локальный метод или свойство. Например, proxy.toString() запускает локальный toString метод в объекте-посреднике. Но proxy.applyHostFunction('toString') вместо этого выполняется toString в объекте прокси-сервера узла.

getHostProperty(propertyName: string): any;

Параметры

propertyName

string

Строковое имя свойства, для которого требуется получить значение.

Возвращаемое значение

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): any;

Параметры

propertyName

string

Имя свойства, для которого задается значение.

propertyValue

any

Значение, заданное свойству.

Возвращаемое значение

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

Значение свойства после его установки.