SVGLengthList: replaceItem() method

{{APIRef("SVG")}}

The replaceItem() method of the {{domxref("SVGLengthList")}} interface replaces an existing item in the list with a new item. If the new item is already in a list, it is removed from its previous list before it is inserted into this list. The inserted item is the item itself and not a copy. If the item is already in this list, note that the index of the item to replace is before the removal of the item.

Syntax

replaceItem(newItem, index)

Parameters

• newItem
  • : The {{domxref("SVGLength")}} to add to the list.
• index
  • : A non-negative integer that specifies the index of the item to delete.

Return value

The {{domxref("SVGLength")}} that was added the list.

Exceptions

• NoModificationAllowedError {{domxref("DOMException")}}
  • : Thrown when the list is read-only.
• IndexSizeError {{domxref("DOMException")}}
  • : Thrown when the index is out of bounds for the list.

Examples

See {{domxref("SVGLengthList")}} for a complete example.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}