loadText
Asynchronously loads the given URL as text. Returns a promise that will resolve to a String once loaded, or reject if the URL failed to load. The data is loaded using XMLHttpRequest, which means that in order to make requests to another origin, the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
Parameters:
Name | Type | Argument | Description |
---|---|---|---|
url |
String | Promise | The URL to request, or a promise for the URL. | |
headers |
Object |
<optional> |
HTTP headers to send with the request. |
Throws:
DeveloperError
: url is required.
Returns:
Promise
a promise that will resolve to the requested data when loaded.
Example
// load text from a URL, setting a custom header loadText('http://someUrl.com/someJson.txt', { 'X-Custom-Header' : 'some value' }).then(function(text) { //Do something with the text }, function() { // an error occurred });