HostObjectAsyncProxyBase class

Paquet:

WebView2Script

Proxy d’objet hôte asynchrone. Les objets hôtes ajoutés via CoreWebView2.AddHostObjectToScript sont exposés en tant que proxys d’objets hôtes à l’aide de window.chrome.webview.hostObjects.{name}. Les proxys d’objet hôte sont des promesses et se résolvent en un objet représentant l’objet hôte. La promesse est rejetée si l’application n’a pas ajouté d’objet portant le nom . Lorsque le code JavaScript accède à une propriété ou à une méthode de l’objet, une promesse est retournée. La promesse est résolue en valeur retournée par l’hôte pour la propriété ou la méthode. La promesse est rejetée en cas d’erreur ; par exemple, aucune propriété ou méthode sur l’objet, ou aucun paramètre n’est valide.

Les proxys d’objet hôte sont des objets proxy JavaScript qui interceptent tous les appels de propriété get, de propriété setet de méthode. Les propriétés ou méthodes qui font partie du Function prototype ou Object sont exécutées dans le moteur JavaScript du document actif. En outre, toutes les propriétés ou méthodes du chrome.webview.hostObjects.options.forceLocalProperties tableau sont également exécutées dans le moteur JavaScript du document actif. Par défaut, il inclut des méthodes facultatives qui ont une signification en JavaScript, comme toJSON et Symbol.toPrimitive. Ajoutez d’autres éléments au tableau en fonction des besoins.

Extends

Function

Méthodes

applyHostFunction(argArray)	Effectuez un appel de méthode sur l’objet hôte qui correspond à ce proxy. Tous les paramètres sont convertis pour appeler la méthode de l’objet hôte.
getHostProperty(propertyName)	Exécutez une propriété get sur l’objet hôte. Utilisez cette méthode pour forcer explicitement l’obtention d’une propriété à se produire à distance si une méthode ou une propriété locale en conflit existe. Par instance, proxy.toString() exécute la méthode locale toString sur l’objet proxy. Mais proxy.applyHostFunction('toString') exécute toString sur l’objet proxié hôte à la place.
getLocalProperty(propertyName)	Exécutez une propriété get localement sur l’objet proxy. Utilisez les méthodes pour forcer l’obtention d’une propriété sur le proxy d’objet hôte plutôt que sur l’objet hôte qu’elle représente. Par instance, proxy.unknownProperty obtient la propriété nommée unknownProperty à partir de l’objet proxié hôte. Mais proxy.getLocalProperty('unknownProperty') obtient la valeur de la propriété unknownProperty sur l’objet proxy.
setHostProperty(propertyName, propertyValue)	Exécutez une propriété set sur l’objet hôte. Utilisez cette méthode pour forcer explicitement une propriété set à se produire à distance si une méthode ou une propriété locale en conflit existe.
setLocalProperty(propertyName, propertyValue)	Exécutez une propriété set localement sur l’objet proxy. Utilisez les méthodes pour forcer la définition d’une propriété sur le proxy d’objet hôte plutôt que sur l’objet hôte qu’il représente. Par instance, proxy.unknownProperty = 2 définit la propriété nommée unknownProperty sur l’objet proxié hôte. Mais proxy.setLocalProperty('unknownProperty', 2) définit la valeur de la propriété unknownProperty sur l’objet proxy.

Détails de la méthode

applyHostFunction(argArray)

Effectuez un appel de méthode sur l’objet hôte qui correspond à ce proxy.

Tous les paramètres sont convertis pour appeler la méthode de l’objet hôte.

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

Paramètres

argArray

any

Tableau d’arguments à passer à l’appel de méthode d’objet hôte.

Retours

Promise<any>

Promesse représentant la valeur convertie de la valeur de retour de l’appel de méthode d’objet hôte.

getHostProperty(propertyName)

Exécutez une propriété get sur l’objet hôte. Utilisez cette méthode pour forcer explicitement l’obtention d’une propriété à se produire à distance si une méthode ou une propriété locale en conflit existe. Par instance, proxy.toString() exécute la méthode locale toString sur l’objet proxy. Mais proxy.applyHostFunction('toString') exécute toString sur l’objet proxié hôte à la place.

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

Paramètres

propertyName

string

Nom de chaîne de la propriété dont obtenir la valeur.

Retours

Promise<any>

Promesse représentant la valeur convertie de la propriété de la propriété de l’objet hôte.

getLocalProperty(propertyName)

Exécutez une propriété get localement sur l’objet proxy. Utilisez les méthodes pour forcer l’obtention d’une propriété sur le proxy d’objet hôte plutôt que sur l’objet hôte qu’elle représente. Par instance, proxy.unknownProperty obtient la propriété nommée unknownProperty à partir de l’objet proxié hôte. Mais proxy.getLocalProperty('unknownProperty') obtient la valeur de la propriété unknownProperty sur l’objet proxy.

getLocalProperty(propertyName: string): any;

Paramètres

propertyName

string

Nom de la propriété pour laquelle obtenir la valeur.

Retours

any

Valeur de la propriété.

setHostProperty(propertyName, propertyValue)

Exécutez une propriété set sur l’objet hôte. Utilisez cette méthode pour forcer explicitement une propriété set à se produire à distance si une méthode ou une propriété locale en conflit existe.

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

Paramètres

propertyName

string

Nom de la propriété dont la valeur doit être définie.

propertyValue

any

Valeur sur laquelle définir la propriété.

Retours

Promise<any>

Promesse représentant la valeur convertie de la propriété de la propriété de l’objet hôte. Cette promesse ne se résout qu’après la modification de la valeur de la propriété.

setLocalProperty(propertyName, propertyValue)

Exécutez une propriété set localement sur l’objet proxy. Utilisez les méthodes pour forcer la définition d’une propriété sur le proxy d’objet hôte plutôt que sur l’objet hôte qu’il représente. Par instance, proxy.unknownProperty = 2 définit la propriété nommée unknownProperty sur l’objet proxié hôte. Mais proxy.setLocalProperty('unknownProperty', 2) définit la valeur de la propriété unknownProperty sur l’objet proxy.

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

Paramètres

propertyName

string

Nom de la propriété dont la valeur doit être définie.

propertyValue

any

Valeur sur laquelle définir la propriété.

Retours

any

Valeur de la propriété après sa définition.