WebGLRenderingContext: getError() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

注意:此功能在 Web Workers 中可用。

WebGLRenderingContext.getError() 方法是 WebGL API 的一部分,用于返回错误信息。

语法

js
getError()

参数

无。

返回值

常量 描述
gl.NO_ERROR 没有错误被记录。此常量的值为 0。
gl.INVALID_ENUM 为枚举参数指定了不可接受的值。命令被忽略,错误标志被设置。
gl.INVALID_VALUE 数字参数超出范围。命令被忽略,错误标志被设置。
gl.INVALID_OPERATION 指定的命令不允许在当前状态下执行。命令被忽略,错误标志被设置。
gl.INVALID_FRAMEBUFFER_OPERATION 当前绑定的帧缓冲器在尝试渲染到它或从中读取时,不是完整帧缓冲器。
gl.OUT_OF_MEMORY 剩余内存不足以执行该命令。
gl.CONTEXT_LOST_WEBGL 如果 WebGL 上下文丢失,则在第一次调用 getError 时返回此错误。之后,直到上下文恢复,它将返回 gl.NO_ERROR

示例

js
gl.getError(); // gl.NO_ERROR (0)

gl.enable(gl.FOOBAR);
gl.getError(); // gl.INVALID_ENUM;

规范

规范
WebGL 规范
# 5.14.3

浏览器兼容性

另见