WebGL2RenderingContext: getQuery() 方法

Baseline 已廣泛支援

此功能已成熟，並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起，所有瀏覽器均已支援此功能。

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

WebGL2RenderingContext.getQuery() 方法是 WebGL 2 API 的一部分，它返回 target 指定的當前活動的 WebGLQuery 物件，或者返回 null。

語法

getQuery(target, pname)

一個 GLenum，指定查詢的目標。可能的值包括：

gl.ANY_SAMPLES_PASSED: 指定一個遮擋查詢：這些查詢用於檢測物件是否可見（即，作用域內的繪圖命令是否通過了深度測試，以及透過的樣本數量）。
gl.ANY_SAMPLES_PASSED_CONSERVATIVE: 與上面相同，但精度較低且速度更快。
gl.TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN: 寫入變換反饋緩衝區（transform feedback buffers）的圖元（primitives）數量。

一個 GLenum，指定查詢物件的目標。必須是 gl.CURRENT_QUERY。

一個 WebGLQuery 物件。

const currentQuery = gl.getQuery(gl.ANY_SAMPLES_PASSED, gl.CURRENT_QUERY);

規範
WebGL 2.0 規範 # 3.7.12

此頁面最後修改於 2025年6月23日，由 MDN 貢獻者更新。