SVGTransformList: removeItem() 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 removeItem() method of the SVGTransformList interface removes an existing item from the list.

Syntax

js
removeItem(index)

Parameters

index

An integer; the index of the item to be removed as an unsigned long.

Return value

An SVGTransform object; the removed item from the list.

Exceptions

This method may raise a DOMException of one of the following types:

NoModificationAllowedError DOMException

Thrown if SVGTransformList corresponds to a read-only attribute or when the object itself is read-only.

IndexSizeError DOMException

Thrown if the index number is greater than or equal to numberOfItems.

Examples

Removing a Transformation from the List

html
<svg width="200" height="200" id="mySvg">
  <rect
    width="100"
    height="100"
    fill="blue"
    transform="translate(50,50) rotate(45)" />
</svg>
js
const svgElement = document.querySelector("svg");
const rectElement = svgElement.querySelector("rect");

// Access the transform list of the <rect> element
const transformList = rectElement.transform.baseVal;

const removedTransform = transformList.removeItem(0);
console.dir(removedTransform); // Output: SVGTransform { type: 2, matrix: SVGMatrix, angle: 0 }

// The updated list length
console.log(`Updated number of transformations: ${transformList.length}`); // Output: 1

Specifications

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__removeItem

Browser compatibility

See also