Mention callback argument count in The JavaScript bridge singleton

This commit is contained in:
Hugo Locurcio
2024-10-29 15:06:02 +01:00
parent 84842ebe00
commit 0d3ccb1f6f

View File

@@ -1,6 +1,6 @@
.. _doc_web_javascript_bridge:
The JavaScriptBridge Singleton
The JavaScriptBridge singleton
==============================
In web builds, the :ref:`JavaScriptBridge <class_JavaScriptBridge>` singleton
@@ -93,6 +93,12 @@ Arguments passed by JavaScript to the callback will be passed as a single Godot
js_event.preventDefault()
js_event.returnValue = ''
.. warning::
The number of arguments accepted by the callback method (``_my_callback`` in the above example)
**must** match the number of arguments sent by JavaScript. Otherwise, the callback method will
not be called.
Here is another example that asks the user for the `Notification permission <https://developer.mozilla.org/en-US/docs/Web/API/Notifications_API>`__
and waits asynchronously to deliver a notification if the permission is
granted: