Freigeben über

HostObjectAsyncProxyBase class

  • Referenz
Paket:
WebView2Script

Ein asynchroner Hostobjektproxy. Über hinzugefügte CoreWebView2.AddHostObjectToScript Hostobjekte werden mithilfe von window.chrome.webview.hostObjects.{name}als Hostobjektproxys verfügbar gemacht. Hostobjektproxys sind Zusagen und werden in ein Objekt aufgelöst, das das Hostobjekt darstellt. Die Zusage wird abgelehnt, wenn die App kein Objekt mit dem Namen hinzugefügt hat. Wenn JavaScript-Code auf eine Eigenschaft oder Methode des Objekts zugreift, wird eine Zusage zurückgegeben. Die Zusage wird in den Wert aufgelöst, der vom Host für die Eigenschaft oder Methode zurückgegeben wird. Die Zusage wird im Falle eines Fehlers abgelehnt; Beispielsweise sind keine Eigenschaft oder Methode für das Objekt oder parameter ungültig.

Hostobjektproxys sind JavaScript-Proxyobjekte, die alle Aufrufe von Eigenschaften get, Eigenschaften setund Methoden abfangen. Eigenschaften oder Methoden, die Teil des Function Prototyps oder Object sind, werden in der JavaScript-Engine des aktuellen Dokuments ausgeführt. Darüber hinaus werden alle Eigenschaften oder Methoden im chrome.webview.hostObjects.options.forceLocalProperties Array auch in der JavaScript-Engine des aktuellen Dokuments ausgeführt. Standardmäßig werden optionale Methoden eingeschlossen, die in JavaScript eine Bedeutung haben, z toJSON . B. und Symbol.toPrimitive. Fügen Sie dem Array nach Bedarf weitere Hinzufügungen hinzu.

Extends

Function

Methoden

applyHostFunction(argArray)

Führen Sie einen Methodenaufruf für das Hostobjekt aus, das diesem Proxy entspricht.

Alle Parameter werden konvertiert, um die Hostobjektmethode aufzurufen.
getHostProperty(propertyName)

Führen Sie eine -Eigenschaft get für das Hostobjekt aus. Verwenden Sie diese Methode, um explizit zu erzwingen, dass eine Eigenschaft per Remotezugriff erfolgt, wenn eine in Konflikt stehende lokale Methode oder Eigenschaft vorhanden ist. Führt für instance proxy.toString() die lokale toString Methode für das Proxyobjekt aus. Aber proxy.applyHostFunction('toString') führt stattdessen toString auf dem Hostproxyobjekt aus.
getLocalProperty(propertyName)

Führen Sie eine Eigenschaft get lokal für das Proxyobjekt aus. Verwenden Sie die -Methoden, um das Abrufen einer Eigenschaft für den Hostobjektproxy und nicht für das von diesem dargestellte Hostobjekt zu erzwingen. Ruft für instance proxy.unknownProperty die Eigenschaft namens unknownProperty aus dem Hostproxyobjekt ab. Ruft jedoch proxy.getLocalProperty('unknownProperty') den Wert der -Eigenschaft unknownProperty für das Proxyobjekt ab.
setHostProperty(propertyName, propertyValue)

Führen Sie eine -Eigenschaft set für das Hostobjekt aus. Verwenden Sie diese Methode, um explizit zu erzwingen, dass eine Eigenschaft set remote auftritt, wenn eine in Konflikt stehende lokale Methode oder Eigenschaft vorhanden ist.
setLocalProperty(propertyName, propertyValue)

Führen Sie eine Eigenschaft set lokal für das Proxyobjekt aus. Verwenden Sie die -Methoden, um das Festlegen einer Eigenschaft für den Hostobjektproxy und nicht für das von diesem dargestellte Hostobjekt zu erzwingen. Legt für instance proxy.unknownProperty = 2 die Eigenschaft mit dem Namen unknownProperty für das Host-Proxyobjekt fest. Legt jedoch proxy.setLocalProperty('unknownProperty', 2) den Wert der -Eigenschaft unknownProperty für das Proxyobjekt fest.

Details zur Methode

applyHostFunction(argArray)

Führen Sie einen Methodenaufruf für das Hostobjekt aus, das diesem Proxy entspricht.

Alle Parameter werden konvertiert, um die Hostobjektmethode aufzurufen.

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

Parameter

argArray

any

Ein Array von Argumenten, die an den Aufruf der Hostobjektmethode übergeben werden sollen.

Gibt zurück

Promise<any>

Eine Zusage, die den konvertierten Wert des Rückgabewerts des Aufrufs der Hostobjektmethode darstellt.

getHostProperty(propertyName)

Führen Sie eine -Eigenschaft get für das Hostobjekt aus. Verwenden Sie diese Methode, um explizit zu erzwingen, dass eine Eigenschaft per Remotezugriff erfolgt, wenn eine in Konflikt stehende lokale Methode oder Eigenschaft vorhanden ist. Führt für instance proxy.toString() die lokale toString Methode für das Proxyobjekt aus. Aber proxy.applyHostFunction('toString') führt stattdessen toString auf dem Hostproxyobjekt aus.

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

Parameter

propertyName

string

Zeichenfolgenname der Eigenschaft, deren Wert abgerufen werden soll.

Gibt zurück

Promise<any>

Eine Zusage, die den konvertierten Wert der -Eigenschaft des Hostobjekts darstellt.

getLocalProperty(propertyName)

Führen Sie eine Eigenschaft get lokal für das Proxyobjekt aus. Verwenden Sie die -Methoden, um das Abrufen einer Eigenschaft für den Hostobjektproxy und nicht für das von diesem dargestellte Hostobjekt zu erzwingen. Ruft für instance proxy.unknownProperty die Eigenschaft namens unknownProperty aus dem Hostproxyobjekt ab. Ruft jedoch proxy.getLocalProperty('unknownProperty') den Wert der -Eigenschaft unknownProperty für das Proxyobjekt ab.

getLocalProperty(propertyName: string): any;

Parameter

propertyName

string

Name der Eigenschaft, für die der Wert abgerufen werden soll.

Gibt zurück

any

Der Wert der Eigenschaft.

setHostProperty(propertyName, propertyValue)

Führen Sie eine -Eigenschaft set für das Hostobjekt aus. Verwenden Sie diese Methode, um explizit zu erzwingen, dass eine Eigenschaft set remote auftritt, wenn eine in Konflikt stehende lokale Methode oder Eigenschaft vorhanden ist.

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

Parameter

propertyName

string

Name der Eigenschaft, deren Wert festgelegt werden soll.

propertyValue

any

Wert, auf den die Eigenschaft festgelegt werden soll.

Gibt zurück

Promise<any>

Eine Zusage, die den konvertierten Wert der -Eigenschaft des Hostobjekts darstellt. Diese Zusage wird erst aufgelöst, nachdem der Eigenschaftswert geändert wurde.

setLocalProperty(propertyName, propertyValue)

Führen Sie eine Eigenschaft set lokal für das Proxyobjekt aus. Verwenden Sie die -Methoden, um das Festlegen einer Eigenschaft für den Hostobjektproxy und nicht für das von diesem dargestellte Hostobjekt zu erzwingen. Legt für instance proxy.unknownProperty = 2 die Eigenschaft mit dem Namen unknownProperty für das Host-Proxyobjekt fest. Legt jedoch proxy.setLocalProperty('unknownProperty', 2) den Wert der -Eigenschaft unknownProperty für das Proxyobjekt fest.

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

Parameter

propertyName

string

Name der Eigenschaft, deren Wert festgelegt werden soll.

propertyValue

any

Wert, auf den die Eigenschaft festgelegt werden soll.

Gibt zurück

any

Der Wert der Eigenschaft, nachdem sie festgelegt wurde.