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

瀏覽器相容性

另見