a geographic extent object


600.4.05 years ago5 years agoMinified + gzip package size for @mapbox/extent in KB


Build Status


A simple geographical extent.



Create a new extent object

extent([w, s, e, n])

Create a new extent object, given bounds as an array.

extent.include([lon, lat])

Expand the extent to include a lon, lat point.

extent.union([w, s, e, n] or other extent)

Expand the extent to include another extent.

extent.equals([w, s, e, n] or other extent)

Whether this extent is exactly equal to another.


Get the extent's value. null if no points have been included yet. Order is [WSEN] to match the GeoJSON standard.


Get the centerpoint of the extent as a [longitude, latitude] array.


Get the extent as a GeoJSON Polygon geometry object.

extent.contains([lon, lat])

Returns true if this extent contains the given point, and false if not. Points on the boundary of the extent are considered to be contained. If the extent is invalid, returns null.


Returns a function that evaluates whether points are contained in the extent - same behavior as .contains([lon, lat]). This pre-compiles the function with the current extent values, yielding a roughly 3x speedup.

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.