---
title: WebGLQuery
slug: Web/API/WebGLQuery
translation_of: Web/API/WebGLQuery
---
<div>{{APIRef("WebGL")}} {{SeeCompatTable}}</div>

<p><strong><code>WebGLQuery</code></strong> 接口是 <a href="/en-US/docs/Web/API/WebGL_API">WebGL 2</a> API 的一部分，并且提供几种异步查询信息的方法。缺省情况下，遮蔽查询和图元查询是可用的。</p>

<p>另一种查询是分离定时器查询，它可以允许你测量GPU的性能和能力。仅当存在 {{domxref("EXT_disjoint_timer_query")}} 扩展时分离定时器查询才是可用的。</p>

<p>使用 <code>WebGLQuery</code> 对象时, {{domxref("WebGL2RenderingContext")}} 的下列方法是有用的:</p>

<ul>
 <li>{{domxref("WebGL2RenderingContext.createQuery()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.deleteQuery()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.isQuery()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.beginQuery()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.endQuery()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.getQuery()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.getQueryParameter()")}}</li>
</ul>

<h2 id="示例">示例</h2>

<h3 id="创建一个_WebGLQuery_对象">创建一个 <code>WebGLQuery</code> 对象</h3>

<p>在本例中，<code>gl</code> 必须是 {{domxref("WebGL2RenderingContext")}}. <code>WebGLQuery</code> 对象在 WebGL 1中是不可用的。</p>

<pre class="brush: js">var query = gl.createQuery();
</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
  <tr>
   <td>{{SpecName('WebGL2', "#3.2", "WebGLQuery")}}</td>
   <td>{{Spec2('WebGL2')}}</td>
   <td>初始定义</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("api.WebGLQuery")}}</p>

<h2 id="参见">参见</h2>

<ul>
 <li>{{domxref("EXT_disjoint_timer_query")}}</li>
</ul>