W3cubDocs

/Web APIs

SVGPointList: replaceItem() 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 replaceItem() method of the SVGPointList interface replaces a DOMPoint in the list.

Syntax

replaceItem(obj, index)

Parameters

obj

A DOMPoint object containing the coordinates of the point to be inserted.

index

The index of the item to replace.

Return value

The new DOMPoint object.

Exceptions

NoModificationAllowedError DOMException

Thrown if the list is read-only.

IndexSizeError DOMException

Thrown if the index passed in is greater than the number of items in the list.

Examples

The following example shows an SVG which contains a <polyline> with five coordinate pairs. A new DOMPoint is created, then replaces the point at index 1 (the second item in the list).

<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");
const point = document.getElementById("svg").createSVGPoint();
point.y = 10;
point.x = 10;
console.log(example.points.replaceItem(point, 1));

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
replaceItem 1 12 1.5 ≤12.1 3 18 4 ≤12.1 1 1.0 3 1

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SVGPointList/replaceItem