CSSFontFeatureValuesMap: Symbol.iterator method

{{APIRef("CSSOM")}}{{SeeCompatTable}}

The [Symbol.iterator]() method of {{domxref("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 {{jsxref("Statements/for...of", "for...of")}} loops. It returns the value of this, which is the iterator object itself.

Syntax

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

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

JavaScript

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Iterator.prototype[Symbol.iterator]()
• {{jsxref("Iterator")}}