Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

JavaScriptBridge

Hereda: Object

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

Descripción

El singleton JavaScriptBridge solo se implementa en la exportación Web. Se utiliza para acceder al contexto de JavaScript del navegador. Esto permite la interacción con páginas incrustadas o la llamada a APIs de JavaScript de terceros.

Nota: Este singleton puede desactivarse en tiempo de compilación para mejorar la seguridad. De forma predeterminada, el singleton JavaScriptBridge está activado. Las plantillas de exportación oficiales también tienen el singleton JavaScriptBridge activado. Véase Compilar para la Web en la documentación para obtener más información.

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") 🔗

Solicita al usuario descargar un archivo que contiene el buffer especificado. El archivo tendrá el name y el tipo mime dados.

Nota: El navegador puede anular el tipo MIME proporcionado basándose en la extensión del name del archivo.

Nota: Los navegadores podrían bloquear la descarga si download_buffer() no se llama desde una interacción del usuario (por ejemplo, un clic de botón).

Nota: Los navegadores podrían pedir permiso al usuario o bloquear la descarga si se realizan varias solicitudes de descarga en rápida sucesión.

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

Ejecuta la string code como código de JavaScript dentro de la ventana del navegador. Esta es una llamada a la función global de JavaScript eval().

Si use_global_execution_context es true, el código se evaluará en el contexto de ejecución global. De lo contrario, se evaluará en el contexto de ejecución de una función dentro del entorno de tiempo de ejecución del motor.

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 ArrayBuffer, DataView, 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.