WebGLRenderingContext: getContextAttributes() 方法

基线 广泛可用

此功能已经很成熟,并在许多设备和浏览器版本上运行。它已在所有浏览器中可用,自 2015 年 7 月.

WebGLRenderingContext.getContextAttributes() 方法返回一个 WebGLContextAttributes 对象,其中包含实际的上下文参数。如果上下文丢失,则可能返回 null

语法

js
getContextAttributes()

参数

无。

返回值

包含实际上下文参数的 WebGLContextAttributes 对象,或者如果上下文丢失,则返回 null

示例

给定此 <canvas> 元素

html
<canvas id="canvas"></canvas>

并给定此 WebGL 上下文

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
gl.getContextAttributes();

getContextAttributes 方法返回一个对象,该对象描述了在此上下文中设置的属性,例如

js
{
  alpha: true,
  antialias: true,
  depth: true,
  failIfMajorPerformanceCaveat: false,
  powerPreference: "default",
  premultipliedAlpha: true,
  preserveDrawingBuffer: false,
  stencil: false,
  desynchronized: false
}

可以使用 HTMLCanvasElement.getContext() 方法在创建上下文时设置上下文属性

js
canvas.getContext("webgl", { antialias: false, depth: false });

有关各个属性的更多信息,请参阅 getContext()

规范

规范
WebGL 规范
# 5.14.2

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参见