---
title: WEBGL_lose_context
slug: Web/API/WEBGL_lose_context
tags:
  - API
  - WebGL
  - WebGL扩展
  - 参考
translation_of: Web/API/WEBGL_lose_context
---
<div>{{APIRef("WebGL")}}</div>

<p><strong>WEBGL_lose_context</strong> 是属于 <a href="/en-US/docs/Web/API/WebGL_API">WebGL API</a> 的一个扩展API，它提供一组方法用来模拟一个 {{domxref("WebGLRenderingContext")}} 上下文的丢失和恢复。</p>

<p>WebGL扩展可以通过 {{domxref("WebGLRenderingContext.getExtension()")}} 方法来使用。更多信息可参阅 <a href="/zh-CN/docs/Web/API/WebGL_API/Tutorial">WebGL教程</a> 中的 <a href="/zh-CN/docs/Web/API/WebGL_API/Using_Extensions">使用WebGL扩展</a> 。</p>

<div class="note">
<p><strong>可用性：</strong>该扩展在 {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} 和 {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} 上下文中都是可用的。</p>
</div>

<h2 id="方法">方法</h2>

<dl>
 <dt>{{domxref("WEBGL_lose_context.loseContext()")}}</dt>
 <dd>模拟上下文丢失。</dd>
 <dt>{{domxref("WEBGL_lose_context.restoreContext()")}}</dt>
 <dd>模拟上下文恢复。</dd>
</dl>

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

<p>使用这个扩展，你可以模拟 {{Event("webglcontextlost")}} 和 {{Event("webglcontextrestored")}} 事件：</p>

<pre class="brush: js">var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');

canvas.addEventListener('webglcontextlost', function(e) {
  console.log(e);
}, false);

gl.getExtension('WEBGL_lose_context').loseContext();

// 打印了 "webglcontextlost" 类型的 WebGLContextEvent 事件。
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('WEBGL_lose_context', "", "WEBGL_lose_context")}}</td>
   <td>{{Spec2('WEBGL_lose_context')}}</td>
   <td>初始定义</td>
  </tr>
 </tbody>
</table>

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

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

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

<ul>
 <li>{{domxref("WebGLRenderingContext.isContextLost()")}}</li>
 <li>事件：{{Event("webglcontextlost")}}, {{Event("webglcontextrestored")}}, {{Event("webglcontextcreationerror")}}</li>
</ul>