CSSFontFeatureValuesMap: [Symbol.iterator]() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The [Symbol.iterator]() method of CSSFontFeatureValuesMap interface implements the iterable protocol and allows built-in iterators to be consumed by most syntaxes expecting iterables, such as the spread syntax and for...of loops. It returns the value of this, which is the iterator object itself.

Syntax

js
iterator[Symbol.iterator]()

Parameters

None.

Return value

The value of this, which is the iterator object itself.

Examples

Basic usage

The following example uses the built-in iterator of CSSFontFeatureValuesMap to log the values using a for...of loop. This example is using @swash but also works with other feature value blocks.

CSS

css
@font-feature-values "MonteCarlo" {
  @swash {
    swishy: 1;
    swashy: 2;
  }
}

JavaScript

js
// get the rules
const myRule = document.styleSheets[0].cssRules[0];
for (const value of myRule.swash.keys()) {
  console.log(value);
}
// Logs: "swishy", "swashy"

Specifications

Specification
CSS Fonts Module Level 4
# cssfontfeaturevaluesmap

Browser compatibility

See also