WebGLRenderingContext: getContextAttributes() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

注意：此功能在 Web Workers 中可用。

WebGLRenderingContext.getContextAttributes() 方法返回一個 WebGLContextAttributes 物件，其中包含實際的上下文引數。如果上下文丟失，則可能返回 null。

語法

getContextAttributes()

引數

無。

返回值

一個 WebGLContextAttributes 物件，其中包含實際的上下文引數，或者在上下文丟失時返回 null。

示例

給定此 <canvas> 元素

html

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

並給定此 WebGL 上下文

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

getContextAttributes 方法返回一個物件，該物件描述了設定在此上下文上的屬性，例如

json

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

上下文屬性可以在使用 HTMLCanvasElement.getContext() 方法建立上下文時設定

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

有關各個屬性的更多資訊，請參閱 getContext()。

規範

規範
WebGL 規範 # 5.14.2

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後由 MDN 貢獻者於 2025 年 4 月 3 日修改。

在 GitHub 上檢視此頁面 • 報告此內容的某個問題