WebGL2RenderingContext: beginQuery() 方法

Baseline 已廣泛支援

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

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

WebGL2RenderingContext.beginQuery() 方法是 WebGL 2 API 的一部分，用於啟動一個非同步查詢。target 引數指示要開始哪種型別的查詢。

語法

beginQuery(target, query)

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

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

要開始查詢的 WebGLQuery 物件。

無（undefined）。

const query = gl.createQuery();
gl.beginQuery(gl.ANY_SAMPLES_PASSED, query);

// …

規範
WebGL 2.0 規範 # 3.7.12

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