// request GeoJson data from USGS remote server
var url = "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_hour.geojson";

esriRequest(url, {
  responseType: "json"
}).then(function(response){
  // The requested data
  var geoJson = response.data;
});

Method Overview

Method Details

esriRequest(url, options){Promise<RequestResponse>}

Retrieves data from a remote server or uploads a file from a user's computer. If the request returns an Error, the error object will include the details specified in EsriErrorDetails.

Parameters:

url String The request URL.

options RequestOptions optional An object with the following properties that describe the request.

Returns:

Type	Description
Promise<RequestResponse>	Returns a promise that resolves to an object with the following specification. If the request returns an Error, the error object will include the details specified in EsriErrorDetails.

Type Definitions

RequestOptions

An object with the following properties that describe the request.

Properties:

callbackParamName String optional Name of the callback parameter (a special service parameter) to be specified when requesting data in JSONP format. It is ignored for all other data formats. For ArcGIS services the value is always callback.

query Object optional Default Value:null If the request URL points to a web server that requires parameters, specify them here.

responseType String optional Default Value:json Response format. When this value is image the method and timeout options are ignored. Possible Values: json | xml | text | blob | array-buffer | document | image

headers Object optional Headers to use for the request. This is an object whose property names are header names. This is not applicable for non-XHR requests.

timeout Number optional Default Value:60000 Indicates the amount of time in milliseconds to wait for a response from the server. Set to 0 to wait for the response indefinitely. This option is ignored when responseType = "image".

method String optional Default Value:auto Indicates if the request should be made using the HTTP POST method. By default, this is determined automatically based on the request size. This option is ignored when responseType = "image". Possible Values: auto | post

body FormData | HTMLFormElement | String optional If uploading a file, specify the form data or element used to submit the file here. If a form element is specified, the parameters of the query will be added to the URL. If not specified, then query parameters will only be added to the URL when a GET request is used. If POST is used, then query parameters will be added to the body.

useProxy Boolean optional Default Value:false Indicates the request should use the proxy. By default this is determined automatically based on the domain of the request url.

cacheBust Boolean optional Default Value:false Indicates whether to send an extra query parameter to ensure the server doesn't supply cached values.

allowImageDataAccess Boolean optional Default Value:false Indicates whether apps are allowed to read image data (when used with Canvas) from images hosted on third-party sites. Only applicable when responseType = "image".

authMode String optional Default Value:auto Indicates if and how requests to ArcGIS Services are authenticated. Only applicable when esriConfig.request.useIdentity = true. Known Value Description auto The user will be signed in when a secure resource is requested. anonymous An error will be returned when a secure resource is requested. immediate The user will be signed in before the resource is requested. no-prompt Checks for whether the user is already signed in. If so, no additional prompts display for sign-in.

RequestResponse

Returns a promise that resolves to an object with the following specification. If the request returns an Error, the error object will include the details specified in EsriErrorDetails.

Properties:

data * optional The requested data. Should match the responseType with the data return type. Possible types are: json, xml, text, blob, array-buffer, document, and image.

requestOptions RequestOptions optional The options specified by the user in the data request. See RequestOptions for available properties.

ssl Boolean optional If ssl is enabled or not.

urls String optional The URL used to request the data.

getHeader() Function optional Method for getting a header sent from the server.

Example:

// request GeoJson data from USGS remote server
var url = "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_hour.geojson";

esriRequest(url, {
  responseType: "json"
}).then(function(response){
  // The requested data
  var geoJson = response.data;
});