SVGPointList: initialize() 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 initialize() method of the SVGPointList interface clears the list then adds a single new DOMPoint object to the list.

Syntax

initialize(obj)

Parameters

obj: A DOMPoint object containing the coordinates of the point to be added when the list is initialized.

Exceptions

NoModificationAllowedError DOMException: Thrown if the list is read-only.

The following example shows an SVG which contains a <polyline> with five coordinate pairs. Returning SVGPointList.length gives the value 5. After calling initialize(), returning SVGPointList.length gives the value 1.

html

<svg id="svg" viewBox="-10 -10 120 120" xmlns="http://www.w3.org/2000/svg">
  <polyline
    id="example"
    stroke="black"
    fill="none"
    points="50,0 21,90 98,35 2,35 79,90" />
</svg>

const example = document.getElementById("example");
console.log(example.points.length); // 5;
const point = document.getElementById("svg").createSVGPoint();
example.points.initialize(point);
console.log(example.points.length); // 1