Partager via


HostObjectSyncProxy class

Proxy d’objet hôte synchrone. 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}. Un proxy d’objet hôte représente un objet hôte.

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 localement. En outre, toute propriété ou méthode dans le chrome.webview.hostObjects.options.forceLocalProperties tableau est également exécutée localement. 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

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.

async()

Méthode qui bloque et retourne un proxy d’objet hôte asynchrone pour le même objet hôte. Par exemple, chrome.webview.hostObjects.sync.sample.methodCall() retourne un proxy d’objet hôte synchrone. L’exécution de la async méthode sur ce bloque, puis retourne un proxy d’objet hôte asynchrone pour le même objet hôte : const asyncProxy = chrome.webview.hostObjects.sync.sample.methodCall().async().

getHostProperty(propertyName)

Exécutez une propriété get sur l’objet hôte. Utilisez cette méthode pour forcer explicitement une propriété get à 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') s’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): any;

Paramètres

argArray

any

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

Retours

any

Valeur convertie de la valeur de retour de l’appel de méthode de l’objet hôte.

async()

Méthode qui bloque et retourne un proxy d’objet hôte asynchrone pour le même objet hôte. Par exemple, chrome.webview.hostObjects.sync.sample.methodCall() retourne un proxy d’objet hôte synchrone. L’exécution de la async méthode sur ce bloque, puis retourne un proxy d’objet hôte asynchrone pour le même objet hôte : const asyncProxy = chrome.webview.hostObjects.sync.sample.methodCall().async().

async(): HostObjectAsyncProxy;

Retours

Proxy d’objet hôte asynchrone pour le même objet hôte.

getHostProperty(propertyName)

Exécutez une propriété get sur l’objet hôte. Utilisez cette méthode pour forcer explicitement une propriété get à 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') s’exécute toString sur l’objet proxié hôte à la place.

getHostProperty(propertyName: string): any;

Paramètres

propertyName

string

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

Retours

any

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): 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 convertie de la propriété de la propriété de l’objet hôte.

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.