---
title: WebGLRenderingContext.getContextAttributes()
slug: Web/API/WebGLRenderingContext/getContextAttributes
translation_of: Web/API/WebGLRenderingContext/getContextAttributes
---
<div>{{APIRef("WebGL")}}</div>

<p><code><strong>WebGLRenderingContext.getContextAttributes()</strong></code> 方法返回一个包含实际上下文参数的 <code>WebGLContextAttributes</code> 对象。如果上下文丢失，可能返回 {{jsxref("null")}}。</p>

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

<pre class="syntaxbox"><var><em>gl</em></var>.getContextAttributes();</pre>

<h3 id="返回值">返回值</h3>

<p>一个包含实际上下文参数的 <code>WebGLContextAttributes</code> 的对象，或 {{jsxref("null")}} （如果上下文丢失）。</p>

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

<p>给定 {{HTMLElement("canvas")}} 元素</p>

<pre class="brush: html">&lt;canvas id="canvas"&gt;&lt;/canvas&gt;
</pre>

<p>和给定 WebGL 上下文</p>

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

<p><code>getContextAttributes</code> 方法返回描述在此上下文中设置的属性的对象，例如：</p>

<pre class="brush: js">{
  alpha: true,
  antialias: true,
  depth: true,
  failIfMajorPerformanceCaveat: false,
  premultipliedAlpha: true,
  preserveDrawingBuffer: false,
  stencil: false
}</pre>

<p>上下文的属性可以在用 {{domxref("HTMLCanvasElement.getContext()")}} 方法创建上下文时设置：</p>

<pre class="brush: js">canvas.getContext('webgl',
                 { antialias: false,
                   depth: false });</pre>

<p>有关各个属性的更多信息，请参阅 {{domxref("HTMLCanvasElement.getContext()", "getContext()")}}。</p>

<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("WebGL", "#5.14.2", "WebGLRenderingContext.getContextAttributes")}}</td>
   <td>{{Spec2("WebGL")}}</td>
   <td>初始定义</td>
  </tr>
 </tbody>
</table>

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

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

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

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