JavaScript
Inherits: Object
在 HTML5 导出中将引擎与浏览器的 JavaScript 上下文连接的单例。
描述
The JavaScript singleton is implemented only in the HTML5 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 JavaScript singleton is enabled. Official export templates also have the JavaScript singleton enabled. See Compiling for the Web in the documentation for more information.
教程
方法
create_callback ( Object object, String method ) | |
create_object ( String object, … ) vararg | |
void | download_buffer ( PoolByteArray buffer, String name, String mime=”application/octet-stream” ) |
eval ( String code, bool use_global_execution_context=false ) | |
get_interface ( String interface ) |
方法说明
- JavaScriptObject create_callback ( Object object, String method )
创建脚本函数的引用,可以被JavaScript用作回调。这个引用必须保持到回调发生为止,否则它就不会被调用。使用方法参阅JavaScriptObject。
使用new
构造函数创建新的JavaScript对象。object
必须是JavaScriptwindow
的有效属性。使用方法参阅JavaScriptObject。
- void download_buffer ( PoolByteArray buffer, String name, String mime=”application/octet-stream” )
提示用户下载一个包含指定buffer
缓冲区的文件。该文件将具有给定的name
和mime
类型。
注意: 浏览器可能会根据文件name
的扩展名,覆盖所提供的MIME类型。
注意: 如果download_buffer不是由用户交互调用,如点击按钮,浏览器可能会阻止下载。
注意: 如果快速连续提出多个下载请求,浏览器可能会要求用户同意或阻止下载。
在浏览器窗口中执行字符串code
作为JavaScript代码。这是对实际的全局JavaScript函数eval()
的调用。
如果use_global_execution_context
是true
,代码将在全局执行环境中被求值。否则,它将在引擎运行时环境中函数的执行上下文中进行求值。
- JavaScriptObject get_interface ( String interface )
返回可以被脚本使用的JavaScript对象的接口。这个interface
必须是JavaScriptwindow
的一个有效属性。回调必须接受一个Array参数,它将包含JavaScript arguments
。参阅JavaScriptObject的用法。