HTMLCanvasElement: height property

The HTMLCanvasElement.height property is a positive integer reflecting the height HTML attribute of the <canvas> element interpreted in CSS pixels. When the attribute is not specified, or if it is set to an invalid value, like a negative, the default value of 150 is used.

When the height property is set the drawing buffer is always reset to blank — this is true for all context types, and even when the height is set to the same value. If you need to restore the previous content, you can save it via CanvasRenderingContext2D.getImageData() and restore it via CanvasRenderingContext2D.putImageData().

This is one of the two properties, the other being HTMLCanvasElement.width, that controls the size of the canvas.

Value

A number.

Examples

Given this <canvas> element:

html
<canvas id="canvas" width="300" height="300"></canvas>

You can get the height of the canvas with the following code:

js
const canvas = document.getElementById("canvas");
console.log(canvas.height); // 300

Specifications

Specification
HTML Standard
# dom-canvas-height

Browser compatibility

BCD tables only load in the browser

See also