MDN self-hosted library · e01.org

SVGLengthList: replaceItem() method

SVG

no runnable cells web-api-instance-method upstream source

SVG

The replaceItem() method of the 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.

Assigning to an index of the list has the same effect as calling this method, except that there is no return value.

Syntax

replaceItem(newItem, index)

Parameters

  • newItem
  • : The SVGLength to add to the list.
  • index
  • : A non-negative integer that specifies the index of the item to delete.

Return value

The SVGLength that was added to the list.

Exceptions

  • NoModificationAllowedError DOMException
  • : Thrown when the list is read-only.
  • IndexSizeError DOMException
  • : Thrown when the index is out of bounds for the list.

Examples

See SVGLengthList for a complete example.

Specifications

Browser compatibility