10.0.0

The 10.0 release brings several significant improvements, including a new base source for image tile sources with improved performance and simplified code. Flat styles handling has been reworked, removing the need to specify type hints among other internal improvements. In the WebGL renderer, a memory allocation issue has been fixed. For better developer experience, we improved generic types and fixed some issues with types, stabilizing the back and forth on generics in v9.x.

Breaking changes are very minor, so we recommend upgrading to v10.x for all v9.x users.

Backwards incompatible changes

ol/source/VectorTile: getFeaturesInExtent() method moved to ol/layer/VectorTile

The getFeaturesInExtent() method of ol/source/VectorTile has been moved to ol/layer/VectorTile. The signature and behavior have not changed, so all that needs to be done is change code from e.g.

layer.getSource().getFeaturesInExtent(extent);

to

layer.getFeaturesInExtent(extent);

Flat styles: Removal of Type hints in 'get' expressions

For the Canvas renderer, additional arguments to the 'get' call expression now mean access to nested properties or array items. The expression system has been improved so type hints are no longer needed. If you were previously using a type hint in a get expression, you have to change the expression from e.g.

['get', 'foo', 'number[]']

to

['get', 'foo']

Other changes

Removal of the opaque option from all Tile sources

The opaque option was previously used to hint the renderer to perform some optimizations on layers known to be fully opaque. This is no longer needed, and the option has been removed.

List of all changes

See below for a complete list of features and fixes.

• Remove outdated doc in FAQ (by @Makio64 in https://github.com/openlayers/openlayers/pull/16026)
• Fix cluster geometryFunction return type (by @NiclasSchmitz in https://github.com/openlayers/openlayers/pull/16021)
• Do not try to handle negative map sizes (by @ahocevar in https://github.com/openlayers/openlayers/pull/16002)
• Re-implement getFeaturesInExtent() method for vector tiles (by @ahocevar in https://github.com/openlayers/openlayers/pull/16007)
• Only reset an existing renderer in setStyle() (by @mike-000 in https://github.com/openlayers/openlayers/pull/16006)
• Fix Linked list concatenateion (by @MoonE in https://github.com/openlayers/openlayers/pull/16003)
• Remove superfluous template argument in ol/layer/VectorTile (by @MoonE in https://github.com/openlayers/openlayers/pull/15999)
• Enable no implicit override check (by @MoonE in https://github.com/openlayers/openlayers/pull/15997)
• Remove last remaining @inheritDoc (by @MoonE in https://github.com/openlayers/openlayers/pull/15996)
• No implicit this (by @MoonE in https://github.com/openlayers/openlayers/pull/15989)
• Fix Raster source attributions bugs (by @MoonE in https://github.com/openlayers/openlayers/pull/15990)
• Cleanup code and fix type declaration (by @MoonE in https://github.com/openlayers/openlayers/pull/15983)
• Add type declarations for mocha and expect.js (by @openlayers in https://github.com/openlayers/openlayers/pull/15982)
• Better generics for rbush (by @MoonE in https://github.com/openlayers/openlayers/pull/15979)
• Attempt to fix deploy preview for pull requests (by @ahocevar in https://github.com/openlayers/openlayers/pull/15973)
• Modernize code (by @MoonE in https://github.com/openlayers/openlayers/pull/15971)
• Rename protected properties, mark properties as private (by @MoonE in https://github.com/openlayers/openlayers/pull/15972)
• Recenter map on overview map click (by @ahocevar in https://github.com/openlayers/openlayers/pull/15963)
• Fix some source createLoader bugs (by @MoonE in https://github.com/openlayers/openlayers/pull/15970)
• Fix control/OverviewMap for setView() (by @kikuchan in https://github.com/openlayers/openlayers/pull/15968)
• Fix control/OverviewMap for useGeographic() (by @kikuchan in https://github.com/openlayers/openlayers/pull/15967)
• Homogenize only one level of KML MultiGeometry (by @mike-000 in https://github.com/openlayers/openlayers/pull/15932)
• WebGL Vector Layer: Clear existing buffers before allocating new ones (by @jahow in https://github.com/openlayers/openlayers/pull/15943)
• Fix polyfills link (by @gtt-project in https://github.com/openlayers/openlayers/pull/15946)
• New image tile source (by @ahocevar in https://github.com/openlayers/openlayers/pull/15905)
• Correct grammatically incorrect use of "an" in documentation (by @mike-000 in https://github.com/openlayers/openlayers/pull/15916)
• Provide expected type when parsing expressions (by @tschaub in https://github.com/openlayers/openlayers/pull/15906)
• Make non-string text styles work again (by @ahocevar in https://github.com/openlayers/openlayers/pull/15898)
• Use offset from start instead of full coordinate to improve getArea() precision (by @mike-000 in https://github.com/openlayers/openlayers/pull/15859)
• Extract feature type from the source's type arguments (by @ahocevar in https://github.com/openlayers/openlayers/pull/15887)
• Consistent generics for vector(tile) layers, sources, formats (by @ahocevar in https://github.com/openlayers/openlayers/pull/15869)
• Fix match expression with numeric size types (by @M393 in https://github.com/openlayers/openlayers/pull/15883)
• VectorSource improvements (by @M393 in https://github.com/openlayers/openlayers/pull/15880)
• Release v9.2.4 (by @openlayers in https://github.com/openlayers/openlayers/pull/15877)
• Fix case expression with numeric size types (by @M393 in https://github.com/openlayers/openlayers/pull/15876)
• Fix allow to pass apiOptions array to Google source (by @KenyStev in https://github.com/openlayers/openlayers/pull/15863)
• Support nested properties with the 'get' expression (by @ahocevar in https://github.com/openlayers/openlayers/pull/15813)
• Fix typo in Snap interaction docs (by @matthias-ccri in https://github.com/openlayers/openlayers/pull/15861)
• Release v9.2.3 (by @openlayers in https://github.com/openlayers/openlayers/pull/15855)
• Add rect example (by @christophfriedrich in https://github.com/openlayers/openlayers/pull/15841)
• Fix execute() arguments (by @ahocevar in https://github.com/openlayers/openlayers/pull/15851)