JavaScriptBridge

Hereda: Object

Singleton que conecta el motor con el contexto de JavaScript del navegador en la exportación Web.

Descripción

The JavaScriptBridge singleton is implemented only in the Web export. It's used to access the browser's JavaScript context. This allows interaction with embedding pages or calling third-party JavaScript APIs.

Note: This singleton can be disabled at build-time to improve security. By default, the JavaScriptBridge singleton is enabled. Official export templates also have the JavaScriptBridge singleton enabled. See Compiling for the Web in the documentation for more information.

Tutoriales

Métodos

JavaScriptObject

create_callback(callable: Callable)

Variant

create_object(object: String, ...) vararg

void

download_buffer(buffer: PackedByteArray, name: String, mime: String = "application/octet-stream")

Variant

eval(code: String, use_global_execution_context: bool = false)

void

force_fs_sync()

JavaScriptObject

get_interface(interface: String)

bool

is_js_buffer(javascript_object: JavaScriptObject)

PackedByteArray

js_buffer_to_packed_byte_array(javascript_buffer: JavaScriptObject)

bool

pwa_needs_update() const

Error

pwa_update()

Señales

pwa_update_available() 🔗

Emitida cuando se ha detectado una actualización para esta aplicación web progresiva pero está esperando a ser activada porque una versión anterior está activa. Véase pwa_update() para forzar que la actualización se realice inmediatamente.

Descripciones de Métodos

JavaScriptObject create_callback(callable: Callable) 🔗

Crea una referencia a un Callable que puede ser utilizado como un callback por JavaScript. La referencia debe mantenerse hasta que el callback se produzca, o no será llamado en absoluto. Véase JavaScriptObject para su uso.

Nota: La función de callback debe tomar exactamente un argumento Array, que va a ser el objeto arguments de JavaScript convertido en un array.

Variant create_object(object: String, ...) vararg 🔗

Crea un nuevo objeto de JavaScript usando el constructor new. El object debe ser una propiedad válida de la window de JavaScript. Véase JavaScriptObject para su uso.

void download_buffer(buffer: PackedByteArray, name: String, mime: String = "application/octet-stream") 🔗

Prompts the user to download a file containing the specified buffer. The file will have the given name and mime type.

Note: The browser may override the MIME type provided based on the file name's extension.

Note: Browsers might block the download if download_buffer() is not being called from a user interaction (e.g. button click).

Note: Browsers might ask the user for permission or block the download if multiple download requests are made in a quick succession.

Variant eval(code: String, use_global_execution_context: bool = false) 🔗

Execute the string code as JavaScript code within the browser window. This is a call to the actual global JavaScript function eval().

If use_global_execution_context is true, the code will be evaluated in the global execution context. Otherwise, it is evaluated in the execution context of a function within the engine's runtime environment.

void force_fs_sync() 🔗

Fuerza la sincronización del sistema de archivos persistente (cuando está habilitado).

**Nota: ** Esto sólo es útil para módulos o extensiones que no pueden usar FileAccess para escribir archivos.

JavaScriptObject get_interface(interface: String) 🔗

Devuelve una interfaz a un objeto de JavaScript que puede ser utilizado por scripts. La interface debe ser una propiedad válida de la ventana de JavaScript ``. El callback debe aceptar un solo argumento :ref:`Array<class_Array>`, el cual contiene los ``arguments de JavaScript. Véase JavaScriptObject para su uso.

bool is_js_buffer(javascript_object: JavaScriptObject) 🔗

Returns true if the given javascript_object is of type [code]ArrayBuffer[/code], [code]DataView[/code], or one of the many typed array objects.

PackedByteArray js_buffer_to_packed_byte_array(javascript_buffer: JavaScriptObject) 🔗

Devuelve una copia del contenido de javascript_buffer como un PackedByteArray. Véase también is_js_buffer().

bool pwa_needs_update() const 🔗

Devuelve true si una nueva versión de la aplicación web progresiva está esperando ser activada.

Nota: Solo es relevante cuando se exporta como una Aplicación Web Progresiva.

Error pwa_update() 🔗

Realiza la actualización en vivo de la aplicación web progresiva. Forzando la instalación de la nueva versión y la recarga de la página.

Nota: Tu aplicación se recargará en todas las pestañas del navegador.

Nota: Solo es relevante cuando se exporta como una Aplicación Web Progresiva y pwa_needs_update() devuelve true.