/** * @module ol/featureloader */ import {UNDEFINED} from './functions.js'; import FormatType from './format/FormatType.js'; /** * @param {string|ol.FeatureUrlFunction} url Feature URL service. * @param {ol.format.Feature} format Feature format. * @param {function(this:ol.VectorTile, Array., ol.proj.Projection, ol.Extent)|function(this:ol.source.Vector, Array.)} success * Function called with the loaded features and optionally with the data * projection. Called with the vector tile or source as `this`. * @param {function(this:ol.VectorTile)|function(this:ol.source.Vector)} failure * Function called when loading failed. Called with the vector tile or * source as `this`. * @return {ol.FeatureLoader} The feature loader. */ export function loadFeaturesXhr(url, format, success, failure) { return ( /** * @param {ol.Extent} extent Extent. * @param {number} resolution Resolution. * @param {ol.proj.Projection} projection Projection. * @this {ol.source.Vector|ol.VectorTile} */ function(extent, resolution, projection) { const xhr = new XMLHttpRequest(); xhr.open('GET', typeof url === 'function' ? url(extent, resolution, projection) : url, true); if (format.getType() == FormatType.ARRAY_BUFFER) { xhr.responseType = 'arraybuffer'; } /** * @param {Event} event Event. * @private */ xhr.onload = function(event) { // status will be 0 for file:// urls if (!xhr.status || xhr.status >= 200 && xhr.status < 300) { const type = format.getType(); /** @type {Document|Node|Object|string|undefined} */ let source; if (type == FormatType.JSON || type == FormatType.TEXT) { source = xhr.responseText; } else if (type == FormatType.XML) { source = xhr.responseXML; if (!source) { source = new DOMParser().parseFromString(xhr.responseText, 'application/xml'); } } else if (type == FormatType.ARRAY_BUFFER) { source = /** @type {ArrayBuffer} */ (xhr.response); } if (source) { success.call(this, format.readFeatures(source, {featureProjection: projection}), format.readProjection(source), format.getLastExtent()); } else { failure.call(this); } } else { failure.call(this); } }.bind(this); /** * @private */ xhr.onerror = function() { failure.call(this); }.bind(this); xhr.send(); } ); } /** * Create an XHR feature loader for a `url` and `format`. The feature loader * loads features (with XHR), parses the features, and adds them to the * vector source. * @param {string|ol.FeatureUrlFunction} url Feature URL service. * @param {ol.format.Feature} format Feature format. * @return {ol.FeatureLoader} The feature loader. * @api */ export function xhr(url, format) { return loadFeaturesXhr(url, format, /** * @param {Array.} features The loaded features. * @param {ol.proj.Projection} dataProjection Data projection. * @this {ol.source.Vector} */ function(features, dataProjection) { this.addFeatures(features); }, /* FIXME handle error */ UNDEFINED); }