Compartir a través de


HostObjectsOptions class

Contiene opciones aplicables a CoreWebView2.AddHostObjectToScript los servidores proxy de script agregados.

Propiedades

defaultSyncProxy

Al llamar a un método en un proxy sincrónico, el resultado también debe ser un proxy sincrónico. Pero en algunos casos, se pierde el contexto de sincronización o asincrónico (por ejemplo, al proporcionar al código nativo una referencia a una función y, a continuación, llamar a esa función en código nativo). En estos casos, el proxy será asincrónico si esta opción es falsey sincrónica si esta opción es true.

forceAsyncMethodMatches

Se trata de una matriz de expresiones regulares. Al llamar a un método en un proxy sincrónico, la llamada al método se realizará de forma asincrónica si el nombre del método coincide con una cadena o expresión regular en esta matriz. Establecer este valor en /Async$/ hará que cualquier método que termine con Async sea una llamada de método asincrónica. Si un método asincrónico no coincide aquí y no se ve obligado a ser asincrónico, el método se invocará sincrónicamente, lo que bloqueará la ejecución de la llamada a JavaScript y, a continuación, devolverá la resolución de la promesa, en lugar de devolver una promesa.

Este valor predeterminado es [].

forceLocalProperties

Se trata de una matriz de nombres de propiedad de objeto de host que se ejecutarán localmente, en lugar de llamarse en el objeto host nativo. Este valor predeterminado es ['then', 'toJSON', Symbol.toString, Symbol.toPrimitive]. Puede agregar otras propiedades para especificar que se deben ejecutar localmente en el proxy de objeto de host javascript.

ignoreMemberNotFoundError

De forma predeterminada, se produce una excepción al intentar obtener el valor de una propiedad de proxy que no existe en la clase nativa correspondiente. Establecer esta propiedad en true cambia el comportamiento para que coincida con el comportamiento de proyección de Chakra WinRT (y JavaScript general) de devolver undefined sin ningún error.

log

Se trata de un delegado de devolución de llamada al que se llamará con información de depuración si no es null.

Por ejemplo, puede establecerlo console.log.bind(console) en para que imprima información de depuración en la consola, para ayudar a solucionar problemas de uso de objetos host.

De forma predeterminada, es null.

shouldPassTypedArraysAsArrays

De forma predeterminada, las matrices con tipo se pasan al host como IDispatch. Para pasar en su lugar matrices con tipo al host como array, establézcala en true.

shouldSerializeDates

De forma predeterminada, es falsey los objetos javascript Date se enviarán a objetos host como una cadena mediante JSON.stringify.

Puede establecer esta propiedad true en para que Date los objetos se serializan correctamente como VT_DATE cuando se envían al objeto host nativo, y hacer que VT_DATE las propiedades y los valores devueltos creen un objeto JavaScript Date .

Detalles de las propiedades

defaultSyncProxy

Al llamar a un método en un proxy sincrónico, el resultado también debe ser un proxy sincrónico. Pero en algunos casos, se pierde el contexto de sincronización o asincrónico (por ejemplo, al proporcionar al código nativo una referencia a una función y, a continuación, llamar a esa función en código nativo). En estos casos, el proxy será asincrónico si esta opción es falsey sincrónica si esta opción es true.

defaultSyncProxy: boolean;

Valor de propiedad

boolean

forceAsyncMethodMatches

Se trata de una matriz de expresiones regulares. Al llamar a un método en un proxy sincrónico, la llamada al método se realizará de forma asincrónica si el nombre del método coincide con una cadena o expresión regular en esta matriz. Establecer este valor en /Async$/ hará que cualquier método que termine con Async sea una llamada de método asincrónica. Si un método asincrónico no coincide aquí y no se ve obligado a ser asincrónico, el método se invocará sincrónicamente, lo que bloqueará la ejecución de la llamada a JavaScript y, a continuación, devolverá la resolución de la promesa, en lugar de devolver una promesa.

Este valor predeterminado es [].

forceAsyncMethodMatches: RegExp[];

Valor de propiedad

RegExp[]

forceLocalProperties

Se trata de una matriz de nombres de propiedad de objeto de host que se ejecutarán localmente, en lugar de llamarse en el objeto host nativo. Este valor predeterminado es ['then', 'toJSON', Symbol.toString, Symbol.toPrimitive]. Puede agregar otras propiedades para especificar que se deben ejecutar localmente en el proxy de objeto de host javascript.

forceLocalProperties: string[];

Valor de propiedad

string[]

ignoreMemberNotFoundError

De forma predeterminada, se produce una excepción al intentar obtener el valor de una propiedad de proxy que no existe en la clase nativa correspondiente. Establecer esta propiedad en true cambia el comportamiento para que coincida con el comportamiento de proyección de Chakra WinRT (y JavaScript general) de devolver undefined sin ningún error.

ignoreMemberNotFoundError: boolean;

Valor de propiedad

boolean

log

Se trata de un delegado de devolución de llamada al que se llamará con información de depuración si no es null.

Por ejemplo, puede establecerlo console.log.bind(console) en para que imprima información de depuración en la consola, para ayudar a solucionar problemas de uso de objetos host.

De forma predeterminada, es null.

log: (...data: any[]) => void;

Valor de propiedad

(...data: any[]) => void

shouldPassTypedArraysAsArrays

De forma predeterminada, las matrices con tipo se pasan al host como IDispatch. Para pasar en su lugar matrices con tipo al host como array, establézcala en true.

shouldPassTypedArraysAsArrays: boolean;

Valor de propiedad

boolean

shouldSerializeDates

De forma predeterminada, es falsey los objetos javascript Date se enviarán a objetos host como una cadena mediante JSON.stringify.

Puede establecer esta propiedad true en para que Date los objetos se serializan correctamente como VT_DATE cuando se envían al objeto host nativo, y hacer que VT_DATE las propiedades y los valores devueltos creen un objeto JavaScript Date .

shouldSerializeDates: boolean;

Valor de propiedad

boolean