CanvasRenderingContext2D: closePath() method

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.

The CanvasRenderingContext2D.closePath() method of the Canvas 2D API attempts to add a straight line from the current point to the start of the current sub-path. If the shape has already been closed or has only one point, this function does nothing.

This method doesn't draw anything to the canvas directly. You can render the path using the stroke() or fill() methods.

Syntax

js
closePath()

Parameters

None.

Return value

None (undefined).

Examples

Closing a triangle

This example creates the first two (diagonal) sides of a triangle using the lineTo() method. After that, the triangle's base is created with the closePath() method, which automatically connects the shape's first and last points.

HTML

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

JavaScript

The triangle's corners are at (20, 140), (120, 10), and (220, 140).

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

ctx.beginPath();
ctx.moveTo(20, 140); // Move pen to bottom-left corner
ctx.lineTo(120, 10); // Line to top corner
ctx.lineTo(220, 140); // Line to bottom-right corner
ctx.closePath(); // Line to bottom-left corner
ctx.stroke();

Result

Closing just one sub-path

This example draws a smiley face consisting of three disconnected sub-paths.

Note: Although closePath() is called after all the arcs have been created, only the last arc (sub-path) gets closed.

HTML

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

JavaScript

The first two arcs create the face's eyes. The last arc creates the mouth.

js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

ctx.beginPath();
ctx.arc(240, 20, 40, 0, Math.PI);
ctx.moveTo(100, 20);
ctx.arc(60, 20, 40, 0, Math.PI);
ctx.moveTo(215, 80);
ctx.arc(150, 80, 65, 0, Math.PI);
ctx.closePath();
ctx.lineWidth = 6;
ctx.stroke();

Result

Specifications

Specification
HTML
# dom-context-2d-closepath-dev

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
closePath

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also