Freigeben über

HostObjectSyncProxy class

  • Referenz
Paket:
WebView2Script

Ein synchroner Hostobjektproxy. Über hinzugefügte CoreWebView2.AddHostObjectToScript Hostobjekte werden mithilfe von window.chrome.webview.hostObjects.{name}als Hostobjektproxys verfügbar gemacht. Ein Hostobjektproxy stellt ein Hostobjekt dar.

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 lokal ausgeführt. Darüber hinaus wird jede Eigenschaft oder Methode im chrome.webview.hostObjects.options.forceLocalProperties Array auch lokal 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.
async()

Eine Methode, die einen asynchronen Hostobjektproxy für dasselbe Hostobjekt blockiert und zurückgibt. Gibt beispielsweise chrome.webview.hostObjects.sync.sample.methodCall() einen synchronen Hostobjektproxy zurück. Das Ausführen der async -Methode für dieses blockiert und gibt dann einen asynchronen Hostobjektproxy für dasselbe Hostobjekt zurück: const asyncProxy = chrome.webview.hostObjects.sync.sample.methodCall().async().
getHostProperty(propertyName)

Führen Sie eine -Eigenschaft get für das Hostobjekt aus. Verwenden Sie diese Methode, um explizit zu erzwingen, dass eine Eigenschaft get remote auftritt, 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. Wird aber proxy.applyHostFunction('toString') stattdessen auf dem Hostproxieobjekt ausgeführt toString .
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): any;

Parameter

argArray

any

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

Gibt zurück

any

Der konvertierte Wert des Rückgabewerts des Hostobjektmethodenaufrufs.

async()

Eine Methode, die einen asynchronen Hostobjektproxy für dasselbe Hostobjekt blockiert und zurückgibt. Gibt beispielsweise chrome.webview.hostObjects.sync.sample.methodCall() einen synchronen Hostobjektproxy zurück. Das Ausführen der async -Methode für dieses blockiert und gibt dann einen asynchronen Hostobjektproxy für dasselbe Hostobjekt zurück: const asyncProxy = chrome.webview.hostObjects.sync.sample.methodCall().async().

async(): HostObjectAsyncProxy;

Gibt zurück

HostObjectAsyncProxy

Ein asynchroner Hostobjektproxy für dasselbe Hostobjekt.

getHostProperty(propertyName)

Führen Sie eine -Eigenschaft get für das Hostobjekt aus. Verwenden Sie diese Methode, um explizit zu erzwingen, dass eine Eigenschaft get remote auftritt, 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. Wird aber proxy.applyHostFunction('toString') stattdessen auf dem Hostproxieobjekt ausgeführt toString .

getHostProperty(propertyName: string): any;

Parameter

propertyName

string

Zeichenfolgenname der Eigenschaft, deren Wert abgerufen werden soll.

Gibt zurück

any

Der konvertierte Wert der -Eigenschaft der -Eigenschaft des Hostobjekts.

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): 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 konvertierte Wert der -Eigenschaft der -Eigenschaft des Hostobjekts.

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.