Extent.intersects() method returns incorrect value

SamLarsen

I am using the esri.geometry.Extent.intersects() method which is returning a boolean true or false based on whether or not the extent intersects the other extent.
The documentation states that it should return the actual intersection extent:
http://help.arcgis.com/en/webapi/javascript/arcgis/help/jsapi_start.htm#jsapi/extent.htm#intersects

Is this a case of the documentation being incorrect or the API being incorrect?

SamLarsen

It appears that the API is correct and the documentation is incorrect or out of date.

For those looking for an actual intersection extent i have extended the API to generate the extent:

dojo.extend(esri.geometry.Extent,{  intersection: function(/*esri.geometry.Extent*/ extent) {   //  summary:    //    Calculate the intersection extent of two extents   //  returns:   //    The intersection extent   //    esri.geometry.Extent || null   var overlap = null;   if(this.intersects(extent)){    //  create a new intersection geometry    overlap = new esri.geometry.Extent(     this.xmin > extent.xmin ? this.xmin : extent.xmin,     this.ymin > extent.ymin ? this.ymin : extent.ymin,     this.xmax < extent.xmax ? this.xmax : extent.xmax,     this.ymax < extent.ymax ? this.ymax : extent.ymax,     this.spatialReference    );   }   return overlap;  } });