The WebGLRenderingContext.canvas
property is a read-only reference to the HTMLCanvasElement
or OffscreenCanvas
object that is associated with the context. It might be null
if it is not associated with a <canvas>
element or an OffscreenCanvas
object.
On this page
WebGLRenderingContext: canvas property
Syntax
js
gl.canvas
Return value
Either a HTMLCanvasElement
or OffscreenCanvas
object or null
.
Examples
Canvas element
Given this <canvas>
element:
html
<canvas id="canvas"></canvas>
You can get back a reference to it from the WebGLRenderingContext
using the canvas
property:
js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
gl.canvas; // HTMLCanvasElement
Offscreen canvas
Example using the experimental OffscreenCanvas
object.
js
const offscreen = new OffscreenCanvas(256, 256);
const gl = offscreen.getContext("webgl");
gl.canvas; // OffscreenCanvas
Specifications
Specification |
---|
WebGL Specification # DOM-WebGLRenderingContext-canvas |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
OffscreenCanvas |
69 | 79 | 105 | No | 56 | No | 69 | 69 | 105 | 48 | No | 10.0 |
canvas |
9 | 12 | 4 | 11 | 12 | 5.1 | 4.4.3 | 25 | 4 | 12 | 8 | 1.5 |
See also
CanvasRenderingContext2D.canvas
- The
OffscreenCanvas
interface
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/canvas