HostObjectAsyncProxyBase class

  • リファレンス
パッケージ:
WebView2Script

非同期ホスト オブジェクト プロキシ。 によって CoreWebView2.AddHostObjectToScript 追加されたホスト オブジェクトは、 を使用して window.chrome.webview.hostObjects.{name}ホスト オブジェクト プロキシとして公開されます。 ホスト オブジェクト プロキシは promise であり、ホスト オブジェクトを表すオブジェクトに解決されます。 アプリが名前を持つオブジェクトを追加していない場合、promise は拒否されます。 JavaScript コードが オブジェクトのプロパティまたはメソッドにアクセスすると、promise が返されます。 promise は、プロパティまたはメソッドのホストから返される値に解決されます。 エラーが発生した場合、promise は拒否されます。たとえば、オブジェクトのプロパティまたはメソッドがない場合、またはパラメーターが無効です。

ホスト オブジェクト プロキシは、すべてのプロパティ get、プロパティ set、メソッドの呼び出しをインターセプトする JavaScript プロキシ オブジェクトです。 または プロトタイプの Function 一部であるプロパティまたは Object メソッドは、現在のドキュメントの JavaScript エンジンで実行されます。 さらに、配列内の chrome.webview.hostObjects.options.forceLocalProperties プロパティまたはメソッドは、現在のドキュメントの JavaScript エンジンでも実行されます。 既定では、 と のような toJSON JavaScript で意味を持つ省略可能なメソッドが Symbol.toPrimitive含まれます。 必要に応じて配列にさらにを追加します。

Extends

CallableFunction

メソッド

applyHostFunction(argArray)

このプロキシに対応するホスト オブジェクトに対してメソッド呼び出しを実行します。

すべてのパラメーターは、ホスト オブジェクト メソッドを呼び出すために変換されます。
getHostProperty(propertyName)

ホスト オブジェクトに対してプロパティ get を実行します。 このメソッドを使用して、競合するローカル メソッドまたはプロパティが存在する場合に、プロパティの取得を明示的にリモートで強制的に実行します。 たとえば、 proxy.toString() プロキシ オブジェクトでローカル toString メソッドを実行します。 ただし、代わりに、proxy.applyHostFunction('toString') はホスト プロキシ オブジェクトで toString を実行します。
getLocalProperty(propertyName)

プロキシ オブジェクトに対してプロパティ get をローカルで実行します。 メソッドを使用して、表すホスト オブジェクトではなく、ホスト オブジェクト プロキシでプロパティを強制的に取得します。 たとえば、 proxy.unknownProperty ホスト プロキシオブジェクトから という名前 unknownProperty のプロパティを取得します。 ただし、 proxy.getLocalProperty('unknownProperty') プロキシ オブジェクトの プロパティ unknownProperty の値を取得します。
setHostProperty(propertyName, propertyValue)

ホスト オブジェクトに対してプロパティ set を実行します。 競合するローカル メソッドまたはプロパティが存在する場合に、プロパティ set を明示的に強制的にリモートで実行するには、このメソッドを使用します。
setLocalProperty(propertyName, propertyValue)

プロキシ オブジェクトに対してプロパティ set をローカルで実行します。 メソッドを使用して、表すホスト オブジェクトではなく、ホスト オブジェクト プロキシにプロパティを強制的に設定します。 たとえば、 proxy.unknownProperty = 2 ホスト プロキシオブジェクトにという名前 unknownProperty のプロパティを設定します。 ただし、 proxy.setLocalProperty('unknownProperty', 2) プロキシ オブジェクトの プロパティ unknownProperty の値を設定します。

メソッドの詳細

applyHostFunction(argArray)

このプロキシに対応するホスト オブジェクトに対してメソッド呼び出しを実行します。

すべてのパラメーターは、ホスト オブジェクト メソッドを呼び出すために変換されます。

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

パラメーター

argArray

any

ホスト オブジェクト メソッドの呼び出しに渡す引数の配列。

戻り値

Promise<any>

ホスト オブジェクト メソッド呼び出しの戻り値の変換された値を表す promise。

getHostProperty(propertyName)

ホスト オブジェクトに対してプロパティ get を実行します。 このメソッドを使用して、競合するローカル メソッドまたはプロパティが存在する場合に、プロパティの取得を明示的にリモートで強制的に実行します。 たとえば、 proxy.toString() プロキシ オブジェクトでローカル toString メソッドを実行します。 ただし、代わりに、proxy.applyHostFunction('toString') はホスト プロキシ オブジェクトで toString を実行します。

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

パラメーター

propertyName

string

値を取得するプロパティの文字列名。

戻り値

Promise<any>

ホスト オブジェクトのプロパティのプロパティの変換された値を表す promise。

getLocalProperty(propertyName)

プロキシ オブジェクトに対してプロパティ get をローカルで実行します。 メソッドを使用して、表すホスト オブジェクトではなく、ホスト オブジェクト プロキシでプロパティを強制的に取得します。 たとえば、 proxy.unknownProperty ホスト プロキシオブジェクトから という名前 unknownProperty のプロパティを取得します。 ただし、 proxy.getLocalProperty('unknownProperty') プロキシ オブジェクトの プロパティ unknownProperty の値を取得します。

getLocalProperty(propertyName: string): any;

パラメーター

propertyName

string

の値を取得するプロパティの名前。

戻り値

any

プロパティの値を表す promise。

setHostProperty(propertyName, propertyValue)

ホスト オブジェクトに対してプロパティ set を実行します。 競合するローカル メソッドまたはプロパティが存在する場合に、プロパティ set を明示的に強制的にリモートで実行するには、このメソッドを使用します。

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

パラメーター

propertyName

string

値を設定するプロパティの名前。

propertyValue

any

プロパティを設定する値。

戻り値

Promise<any>

ホスト オブジェクトのプロパティのプロパティの変換された値を表す promise。 この promise は、プロパティ値が変更された後にのみ解決されます。

setLocalProperty(propertyName, propertyValue)

プロキシ オブジェクトに対してプロパティ set をローカルで実行します。 メソッドを使用して、表すホスト オブジェクトではなく、ホスト オブジェクト プロキシにプロパティを強制的に設定します。 たとえば、 proxy.unknownProperty = 2 ホスト プロキシオブジェクトにという名前 unknownProperty のプロパティを設定します。 ただし、 proxy.setLocalProperty('unknownProperty', 2) プロキシ オブジェクトの プロパティ unknownProperty の値を設定します。

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

パラメーター

propertyName

string

の値を取得するプロパティの名前。

propertyValue

any

プロパティを に設定する値。

戻り値

any

プロパティが設定された後の値を表す promise。 この promise は、プロパティが値を変更した後にのみ解決されます。