---
title: WEBGL_lose_context.loseContext()
slug: Web/API/WEBGL_lose_context/loseContext
tags:
  - API
  - Method
  - Reference
  - WebGL
  - WebGL extension
translation_of: Web/API/WEBGL_lose_context/loseContext
---
<div>{{APIRef("WebGL")}}</div>

<p><strong>WEBGL_lose_context.loseContext()</strong>属于 <a href="/en-US/docs/Web/API/WebGL_API">WebGL API</a>， 一般用来模拟 {{domxref("WebGLRenderingContext")}} 的上下文丢失。</p>

<p>这个方法会触发WebGL规范中上下文丢失的相关事件。通过这个方法丢失的上下文可以通过 {{domxref("WEBGL_lose_context.restoreContext()")}} 恢复。</p>

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

<pre class="syntaxbox">gl.getExtension('WEBGL_lose_context').loseContext();</pre>

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

<p>你可以用这个方法模拟 <code><a href="/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event">webglcontextlost</a></code> 事件：</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事件被触发。
</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.loseContext")}}</td>
   <td>{{Spec2('WEBGL_lose_context')}}</td>
   <td>Initial definition.</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>事件： <code><a href="/en-US/docs/Web/API/HTMLCanvasElement/webglcontextlost_event">webglcontextlost</a></code>, <code><a href="/en-US/docs/Web/API/HTMLCanvasElement/webglcontextrestored_event">webglcontextrestored</a></code>, <code><a href="/en-US/docs/Web/API/HTMLCanvasElement/webglcontextcreationerror_event">webglcontextcreationerror</a></code></li>
</ul>