文档手册

全局变量和方法2

2024-07-10 16:26:26

全局变量和方法

Console

 console.log()

console.log(...)

将日志消息打印到应用程序配置的调试输出流或检查器的日志视图。

console.log("format", ...)

使用 C 样式的 printf 约定打印日志消息。

 console.warn()

console.error()

console.log() 相同,但使用不同的元类型打印消息。

console.reportException(错误,是承诺)

未处理的异常处理程序,所有未处理的异常都转到此处。可以重写此函数以实现自定义处理程序:

console.reportException = function(err,isPromise) {
Window.this.modal(<alert>{err.toString()}</alert>);
return "";
}

 计时器和间隔

 setTimeout()

setTimeout(func:function,milliseconds:int): timerId

在毫秒超时后调用 func。

该函数返回可与 clearTimeout()

clearTimeout()

clearTimeout(timerId)

该函数取消之前创建的计时器。

tip::: Sciter 还提供了可以用作超时和间隔的元素计时器:

 document.timer(500ms, ()=>{ ... });

在某些情况下,它们更灵活,因为它们还支持自动取消以实现有效的呼叫限制。:::

 setInterval()

setInterval(func,milliseconds): intId

以毫秒为间隔定期调用函数。Retuns 间隔 ID。

 clearInterval()

 clearInterval(intId)

按其 intId 停止间隔。

requestAnimationFrame()

requestAnimationFrame(func): animId

计划在下一次绘制事件(通常为 <= 16ms - 60 FPS)时执行 func。

该函数执行一次,因此对于定期调用,需要再次在该函数中调用它。

cancelAnimationFrame(a) (取消动画帧)

cancelAnimationFrame(animId)

 HTTP 客户端

 fetch()

fetch(url:string | Request [, options:object]): Response

 请参阅 Fetch

 特定于 Sciter

 printf()

printf(format:string, ...):string

此函数使用 C 样式的 printf 约定设置参数的格式。

返回格式化的字符串。

在 Sciter 中,标准格式类型列表由以下两个扩展:

  • %v - 获取参数并将其打印为 JSON.stringify(arg) ;

  • %V - 获取参数并将其打印为 JSON.stringify(arg, null, "  ") ;

 scanf()

scanf(format:string, input: string) : [...]

获取输入字符串,并使用 C 样式 scanf 约定根据格式规范对其进行分析。

返回成功分析值的列表(数组)。

 evalModule()

evalModule(text:string [,url:string]):object

JS stock eval() 函数的“module”版本 - 将文本作为模块主体进行计算。

如果提供了 url,则将其用作基本 URL,用于解析内部语句中的 import ... from "relpath" 相对路径。

该函数将模块的导出数据作为对象返回。

 loadScript()

loadScript(url:string);

在 url 中同步加载和执行 JavaScript。

 这相当于

document.append(<script src=url />);

但没有物理 DOM 更新。

 loadScriptModule()

loadScriptModule(url:string): object

在 url 上同步加载和执行 JavaScript 模块。返回模块导出对象。

 这相当于

document.append(<script src=url />);

但没有物理 DOM 更新。

 全局属性

globalThis

object,全局命名空间,别名为 window 与浏览器兼容。

 devicePixelRatio

float,逻辑 CSS px 中的物理屏幕像素数 (dip)。