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.
Name | Type | Description |
---|---|---|
url |
String | The URL to request. |
headers |
Object | optional HTTP headers to send with the request. |
request |
Request | optional The request object. Intended for internal use only. |
Returns:
a promise that will resolve to the requested data when loaded. Returns undefined if
request.throttle
is true and the request does not have high enough priority.
Example:
// load text from a URL, setting a custom header
Cesium.loadText('http://someUrl.com/someJson.txt', {
'X-Custom-Header' : 'some value'
}).then(function(text) {
// Do something with the text
}).otherwise(function(error) {
// an error occurred
});