---
title: "SVGStringList | JavaScript maps SDK"
description: "Documentation for MapTiler SDK"
---

# Interface SVGStringList

The **`SVGStringList`** interface defines a list of strings.

[MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList)

interface SVGStringList {  
    [length](#length): number;  
    [numberOfItems](#numberofitems): number;  
    ["\[iterator\]"](#iterator-1)(): [ArrayIterator](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.ArrayIterator/)<string\>;  
    [appendItem](#appenditem-1)(newItem: string): string;  
    [clear](#clear-1)(): void;  
    [getItem](#getitem-1)(index: number): string;  
    [initialize](#initialize-1)(newItem: string): string;  
    [insertItemBefore](#insertitembefore-1)(newItem: string, index: number): string;  
    [removeItem](#removeitem-1)(index: number): string;  
    [replaceItem](#replaceitem-1)(newItem: string, index: number): string;  
    \[index: number\]: string;  
}

#### Indexable

-   \[index: number\]: string
    

##### Index

### Properties[](#properties)

[length](#length) [numberOfItems](#numberofitems)

### Methods[](#methods)

[\[iterator\]](#iterator) [appendItem](#appenditem) [clear](#clear) [getItem](#getitem) [initialize](#initialize) [insertItemBefore](#insertitembefore) [removeItem](#removeitem) [replaceItem](#replaceitem)

## Properties[](#properties-1)

### `Readonly`length[](#length)

length: number

The **`length`** property of the SVGStringList interface returns the number of items in the list. It is an alias of numberOfItems to make SVG lists more array-like.

[MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/length)

### `Readonly`numberOfItems[](#numberofitems)

numberOfItems: number

The **`numberOfItems`** property of the SVGStringList interface returns the number of items in the list. length is an alias of it.

[MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/numberOfItems)

## Methods[](#methods-1)

### \[iterator\][](#iterator)

-   "\[iterator\]"(): [ArrayIterator](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.ArrayIterator/)<string\>[](#iterator-1)
    
    #### Returns [ArrayIterator](https://docs.maptiler.com/sdk-js/api-reference/interfaces/Externals.ArrayIterator/)<string\>
    

### appendItem[](#appenditem)

-   appendItem(newItem: string): string[](#appenditem-1)
    
    The **`appendItem()`** method of the SVGStringList interface inserts a new item at the end of the list. If the given 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.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/appendItem)
    
    #### Parameters
    
    -   newItem: string
    
    #### Returns string
    

### clear[](#clear)

-   clear(): void[](#clear-1)
    
    The **`clear()`** method of the SVGStringList interface clears all existing items from the list, with the result being an empty list.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/clear)
    
    #### Returns void
    

### getItem[](#getitem)

-   getItem(index: number): string[](#getitem-1)
    
    The **`getItem()`** method of the SVGStringList interface returns the specified item from the list. The returned item is the item itself and not a copy. Any changes made to the item are immediately reflected in the list. The first item is indexed 0.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/getItem)
    
    #### Parameters
    
    -   index: number
    
    #### Returns string
    

### initialize[](#initialize)

-   initialize(newItem: string): string[](#initialize-1)
    
    The **`initialize()`** method of the SVGStringList interface clears all existing items from the list and re-initializes the list to hold the single item specified by the parameter. If the inserted 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. The return value is the item inserted into the list.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/initialize)
    
    #### Parameters
    
    -   newItem: string
    
    #### Returns string
    

### insertItemBefore[](#insertitembefore)

-   insertItemBefore(newItem: string, index: number): string[](#insertitembefore-1)
    
    The **`insertItemBefore()`** method of the SVGStringList interface inserts a new item into the list at the specified position. The first item is indexed 0. The inserted item is the item itself and not a copy.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/insertItemBefore)
    
    #### Parameters
    
    -   newItem: string
    -   index: number
    
    #### Returns string
    

### removeItem[](#removeitem)

-   removeItem(index: number): string[](#removeitem-1)
    
    The **`removeItem()`** method of the SVGStringList interface removes an existing item at the given index from the list.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/removeItem)
    
    #### Parameters
    
    -   index: number
    
    #### Returns string
    

### replaceItem[](#replaceitem)

-   replaceItem(newItem: string, index: number): string[](#replaceitem-1)
    
    The **`replaceItem()`** method of the SVGStringList interface replaces an existing item in the list with a new item. The inserted item is the item itself and not a copy.
    
    [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGStringList/replaceItem)
    
    #### Parameters
    
    -   newItem: string
    -   index: number
    
    #### Returns string