WebGLRenderingContext: getContextAttributes() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.getContextAttributes()-Methode gibt ein WebGLContextAttributes-Objekt zurück, das die tatsächlichen Kontextparameter enthält. Kann null zurückgeben, wenn der Kontext verloren geht.

Syntax

getContextAttributes()

Parameter

Keine.

Rückgabewert

Ein WebGLContextAttributes-Objekt, das die tatsächlichen Kontextparameter enthält, oder null, wenn der Kontext verloren geht.

Beispiele

Gegeben ist dieses <canvas>-Element

html

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

und dieser WebGL-Kontext

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

Die getContextAttributes-Methode gibt ein Objekt zurück, das die auf diesen Kontext gesetzten Attribute beschreibt, zum Beispiel:

json

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

Die Kontextattribute können beim Erstellen des Kontexts mit der HTMLCanvasElement.getContext()-Methode gesetzt werden:

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

Weitere Informationen zu den einzelnen Attributen finden Sie unter getContext().

Spezifikationen

Specification
WebGL Specification # 5.14.2