HostObjectAsyncProxyBase class

Pacote:
WebView2Script

Um proxy de objeto host assíncrono. Os objetos host adicionados por meio de CoreWebView2.AddHostObjectToScript são expostos como proxies de objeto host usando.window.chrome.webview.hostObjects.{name} Os proxies de objeto host são promessas e são resolvidos para um objeto que representa o objeto host. A promessa será rejeitada se o aplicativo não tiver adicionado um objeto com o nome. Quando o código JavaScript acessa uma propriedade ou método do objeto, uma promessa é retornada. A promessa é resolvida para o valor retornado do host para a propriedade ou o método. A promessa é rejeitada em caso de erro; Por exemplo, nenhuma propriedade ou método no objeto ou parâmetros não são válidos.

Os proxies de objeto host são objetos JavaScript Proxy que interceptam todas as invocações de propriedade get, propriedade sete método. As propriedades ou métodos que fazem parte do Function protótipo ou Object são executados no mecanismo JavaScript do documento atual. Além disso, qualquer propriedade ou método na chrome.webview.hostObjects.options.forceLocalProperties matriz também é executado no mecanismo JavaScript do documento atual. O padrão é incluir métodos opcionais que têm significado em JavaScript, como toJSON e Symbol.toPrimitive. Adicione mais à matriz conforme necessário.

Extends

Function

Métodos

applyHostFunction(argArray)

Execute uma invocação de método no objeto host que corresponde a esse proxy.

Todos os parâmetros são convertidos para chamar o método de objeto host.
getHostProperty(propertyName)

Execute uma propriedade get no objeto host. Use esse método para forçar explicitamente uma propriedade a ocorrer remotamente se houver um método ou propriedade local conflitante. Por exemplo, proxy.toString() executa o método local toString no objeto proxy. Mas proxy.applyHostFunction('toString') executa toString no objeto com proxy do host.
getLocalProperty(propertyName)

Execute uma propriedade get localmente no objeto proxy. Use os métodos para forçar a obtenção de uma propriedade no proxy de objeto host em vez de no objeto host que ele representa. Por exemplo, proxy.unknownProperty obtém a propriedade nomeada unknownProperty do objeto com proxy do host. Mas proxy.getLocalProperty('unknownProperty') obtém o valor da propriedade unknownProperty no objeto proxy.
setHostProperty(propertyName, propertyValue)

Execute uma propriedade set no objeto host. Use esse método para forçar explicitamente uma propriedade set a ocorrer remotamente se houver um método ou propriedade local conflitante.
setLocalProperty(propertyName, propertyValue)

Execute uma propriedade set localmente no objeto proxy. Use os métodos para forçar a configuração de uma propriedade no proxy de objeto host em vez de no objeto host que ele representa. Por exemplo, proxy.unknownProperty = 2 define a propriedade nomeada unknownProperty no objeto com proxy do host. Mas proxy.setLocalProperty('unknownProperty', 2) define o valor da propriedade unknownProperty no objeto proxy.

Detalhes do método

applyHostFunction(argArray)

Execute uma invocação de método no objeto host que corresponde a esse proxy.

Todos os parâmetros são convertidos para chamar o método de objeto host.

applyHostFunction(argArray?: any): Promise<any>;

Parâmetros

argArray

any

Uma matriz de argumentos a serem passados para a invocação do método de objeto host.

Retornos

Promise<any>

Uma promessa que representa o valor convertido do valor retornado da invocação do método de objeto host.

getHostProperty(propertyName)

Execute uma propriedade get no objeto host. Use esse método para forçar explicitamente uma propriedade a ocorrer remotamente se houver um método ou propriedade local conflitante. Por exemplo, proxy.toString() executa o método local toString no objeto proxy. Mas proxy.applyHostFunction('toString') executa toString no objeto com proxy do host.

getHostProperty(propertyName: string): Promise<any>;

Parâmetros

propertyName

string

Nome da cadeia de caracteres da propriedade da qual obter o valor.

Retornos

Promise<any>

Uma promessa que representa o valor convertido da propriedade da propriedade do objeto host.

getLocalProperty(propertyName)

Execute uma propriedade get localmente no objeto proxy. Use os métodos para forçar a obtenção de uma propriedade no proxy de objeto host em vez de no objeto host que ele representa. Por exemplo, proxy.unknownProperty obtém a propriedade nomeada unknownProperty do objeto com proxy do host. Mas proxy.getLocalProperty('unknownProperty') obtém o valor da propriedade unknownProperty no objeto proxy.

getLocalProperty(propertyName: string): any;

Parâmetros

propertyName

string

Nome da propriedade da qual obter o valor.

Retornos

any

O valor da propriedade.

setHostProperty(propertyName, propertyValue)

Execute uma propriedade set no objeto host. Use esse método para forçar explicitamente uma propriedade set a ocorrer remotamente se houver um método ou propriedade local conflitante.

setHostProperty(propertyName: string, propertyValue: any): Promise<any>;

Parâmetros

propertyName

string

Nome da propriedade que definirá o valor.

propertyValue

any

Valor para definir a propriedade.

Retornos

Promise<any>

Uma promessa que representa o valor convertido da propriedade da propriedade do objeto host. Essa promessa só é resolvida depois que o valor da propriedade é alterado.

setLocalProperty(propertyName, propertyValue)

Execute uma propriedade set localmente no objeto proxy. Use os métodos para forçar a configuração de uma propriedade no proxy de objeto host em vez de no objeto host que ele representa. Por exemplo, proxy.unknownProperty = 2 define a propriedade nomeada unknownProperty no objeto com proxy do host. Mas proxy.setLocalProperty('unknownProperty', 2) define o valor da propriedade unknownProperty no objeto proxy.

setLocalProperty(propertyName: string, propertyValue: any): any;

Parâmetros

propertyName

string

Nome da propriedade que definirá o valor.

propertyValue

any

Valor para definir a propriedade.

Retornos

any

O valor da propriedade depois de definida.