Creates a new Sass map.
The initial keys and values of the map are undefined. They must be set using setKey and setValue before accessing them or passing the map back to Sass.
constmap = newsass.types.Map(2);
map.setKey(0, newsass.types.String("width"));
map.setValue(0, newsass.types.Number(300, "px"));
map.setKey(1, newsass.types.String("height"));
map.setValue(1, newsass.types.Number(100, "px"));
map; // (width: 300px, height: 100px)
The number of (initially undefined) key/value pairs in the map.
Returns the key in the key/value pair at index.
// map is `(width: 300px, height: 100px)`
map.getKey(0); // width
map.getKey(1); // height
Error if index is less than 0 or greater than or equal to the number of pairs in this map.
A (0-based) index of a key/value pair in this map.
Returns the number of key/value pairs in this map.
// map is `("light": 200, "medium": 400, "bold": 600)`
map.getLength(); // 3
// map is `(width: 300px, height: 100px)`
map.getLength(); // 2
Returns the value in the key/value pair at index.
// map is `(width: 300px, height: 100px)`
map.getValue(0); // 300px
map.getValue(1); // 100px
Error if index is less than 0 or greater than or equal to the number of pairs in this map.
A (0-based) index of a key/value pair in this map.
Sets the value in the key/value pair at index to value.
// map is `("light": 200, "medium": 400, "bold": 600)`
map.setValue(1, newsass.types.String("lighter"));
map; // ("lighter": 200, "medium": 300, "bold": 600)
Error if index is less than 0 or greater than or equal to the number of pairs in this map.
A (0-based) index of a key/value pair in this map.
Sets the value in the key/value pair at index to value.
// map is `("light": 200, "medium": 400, "bold": 600)`
map.setValue(1, newsass.types.Number(300));
map; // ("light": 200, "medium": 300, "bold": 600)
Error if index is less than 0 or greater than or equal to the number of pairs in this map.
A (0-based) index of a key/value pair in this map.
© 2006–2025 the Sass team, and numerous contributors
Licensed under the MIT License.
https://sass-lang.com/documentation/js-api/classes/types.Map
Sass's map type.
This map type is represented as a list of key-value pairs rather than a mapping from keys to values. The only way to find the value associated with a given key is to iterate through the map checking for that key. Maps created through this API are still forbidden from having duplicate keys.