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

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Class ColorArray

An array of colors. Create instances from bare arrays or strings using the static method `ColorArray.parse`.

#### Private[](#private)

##### Index

### Constructors[](#constructors)

[constructor](#constructor)

### Properties[](#properties)

[values](#values)

### Methods[](#methods)

[toString](#tostring) [interpolate](#interpolate) [parse](#parse)

## Constructors[](#constructors-1)

### constructor[](#constructor)

-   new ColorArray(values: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\]): ColorArray[](#constructorcolorarray)
    
    #### Parameters
    
    -   values: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\]
    
    #### Returns ColorArray
    

## Properties[](#properties-1)

### values[](#values)

values: [Color](https://docs.maptiler.com/sdk-js/api-reference/classes/Color/)\[\]

## Methods[](#methods-1)

### toString[](#tostring)

-   toString(): string[](#tostring-1)
    
    #### Returns string
    

### `Static`interpolate[](#interpolate)

-   interpolate(  
        from: ColorArray,  
        to: ColorArray,  
        t: number,  
        spaceKey?: [InterpolationColorSpace](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.InterpolationColorSpace/),  
    ): ColorArray[](#interpolate-1)
    
    #### Parameters
    
    -   from: ColorArray
    -   to: ColorArray
    -   t: number
    -   `Optional`spaceKey: [InterpolationColorSpace](https://docs.maptiler.com/sdk-js/api-reference/types/Externals.InterpolationColorSpace/)
    
    #### Returns ColorArray
    

### `Static`parse[](#parse)

-   parse(input?: string | string\[\] | ColorArray | null): ColorArray | undefined[](#parse-1)
    
    ColorArray values
    
    #### Parameters
    
    -   `Optional`input: string | string\[\] | ColorArray | null
        
        A ColorArray value
        
    
    #### Returns ColorArray | undefined
    
    A `ColorArray` instance, or `undefined` if the input is not a valid ColorArray value.