17292947856

Committed 28 Aug 2025 10:21AM UTC coverage: 86.774% (-0.2%) from 86.927%

Build # 17292947856

Build Type

Pull #2593

github

Committed by

web-flow

Commit Message

Merge 3396d4fd1 into 737a8f3de

Pull Request Pull Request #2593: Refactoring sources

Run Details

2792 of 3749 branches covered (74.47%)

Branch coverage included in aggregate %.

459 of 531 new or added lines in 18 files covered. (86.44%)

10 existing lines in 5 files now uncovered.

26155 of 29610 relevant lines covered (88.33%)

1094.86 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

89.59

/packages/Main/src/Source/WMSSource.js

import { Extent, CRS } from '@itowns/geographic';
import { bbox, subDomains } from 'Provider/URLBuilder';
import Fetcher from 'Provider/Fetcher';
import URLSource from './URLSource';

const _extent = new Extent('EPSG:4326');

/**
 * Proj provides an optional param to define axis order and orientation for a
 * given projection. 'enu' for instance stands for east, north, up.
 * Elevation is not needed here. The two first characters are sufficient to map
 * proj axis to iTowns bbox order formalism.
 * 'enu' corresponds to 'wsen' because bbox starts by lower value coordinates
 * and preserves axis ordering, here long/lat.
 */
const projAxisToBboxMappings = {
    en: 'wsen',
    es: 'wnes',
    wn: 'eswn',
    ws: 'enws',
    ne: 'swne',
    se: 'nwse',
    nw: 'senw',
    sw: 'nesw',
};

/**
 * Provides the bbox axis order matching provided proj4 axis
 * @param {string} projAxis the CRS axis order as defined in proj4
 * @returns {string} the corresponding bbox axis order to use for WMS 1.3.0
 */
function projAxisToWmsBbox(projAxis) {
    return projAxis && projAxisToBboxMappings[projAxis.slice(0, 2)] || 'wsen';
}

/**
 * An object defining the source of images to get from a
 * [WMS](http://www.opengeospatial.org/standards/wms) server. It inherits
 * from {@link Source}.
 *
 * @extends Source
 *
 * @property {boolean} isWMSSource - Used to checkout whether this source is a
 * WMSSource. Default is true. You should not change this, as it is used
 * internally for optimisation.
 * @property {string} name - The name of the layer, used in the generation of
 * the url.
 * @property {string} version - The version of the WMS server to request on.
 * Default value is '1.3.0'.
 * @property {string} style - The style to query on the WMS server. Default
 * value is 'normal'.
 * @property {number} width - The width of the image to fetch, in pixel.
 * Default value is the height if set or 256.
 * @property {number} height - The height of the image to fetch, in pixel.
 * Default value is the width if set or 256.
 * @property {string} axisOrder - The order of the axis, that helps building the
 * BBOX to put in the url requesting a resource. Default value is 'wsen', other
 * value can be 'swne'.
 * @property {boolean} transparent - Tells if the image to fetch needs
 * transparency support. Default value is false.
 * @property {Object} zoom - Object containing the minimum and maximum values of
 * the level, to zoom in the source.
 * @property {number} zoom.min - The minimum level of the source. Default value
 * is 0.
 * @property {number} zoom.max - The maximum level of the source. Default value
 * is 21.
 * @property {string} bboxDigits - The bbox digits precision used in URL
 * @property {Object} vendorSpecific - An object containing vendor specific
 * parameters. See for example a [list of these parameters for GeoServer](
 * https://docs.geoserver.org/latest/en/user/services/wms/vendor.html). This
 * object is read simply with the `key` being the name of the parameter and
 * `value` being the value of the parameter. If used, this property should be
 * set in the constructor parameters.
 *
 * @example
 * // Create the source
 * const wmsSource = new itowns.WMSSource({
 *     url: 'https://server.geo/wms',
 *     version: '1.3.0',
 *     name: 'REGION.2016',
 *     style: '',
 *     crs: 'EPSG:3857',
 *     extent: {
 *         west: '-6880639.13557728',
 *         east: '6215707.87974825',
 *         south: '-2438399.00148845',
 *         north: '7637050.03850605',
 *     },
 *     transparent: true,
 * });
 *
 * // Create the layer
 * const colorlayer = new itowns.ColorLayer('Region', {
 *     source: wmsSource,
 * });
 *
 * // Add the layer
 * view.addLayer(colorlayer);
 */
class WMSSource extends URLSource {
    /**
     * @param {Object} source - An object that can contain all properties of
     * WMSSource and {@link Source}. `url`, `name`, `extent` and `crs`
     * are mandatory.
     */
    constructor(source) {
        const {
            name,
            extent,
            crs,
            format = 'image/png',
            fetcher = Fetcher.get(format),
            parser = ((d, opt) => { d.extent = opt.extent; return d; }),
            style = '',
            width = source.height || 256,
            height = source.width || 256,
            version = '1.3.0',
            transparent = false,
            bboxDigits,
            axisOrder,
            vendorSpecific,
        } = source;

        if (!name) {
            throw new Error('[WMSSource]: source.name is required.');
        }

        if (!extent) {
            throw new Error('[WMSSource]: source.extent is required');
        }

        if (!crs) {
            throw new Error('[WMSSource]: source.crs is required');
        }

        super({ ...source, fetcher, parser });

        this.isWMSSource = true;
        this.format = format;
        this.name = name;
        this.zoom = { min: 0, max: Infinity };
        this.style = style;

        this.width = width;
        this.height = height;
        this.version = version;
        this.transparent = transparent;
        this.bboxDigits = bboxDigits;

        if (axisOrder) {
            this.axisOrder = axisOrder;
        } else if (this.version === '1.3.0') { // If not set, axis order depends on WMS version
            // Version 1.3.0 depends on CRS axis order as defined in epsg.org database
            this.axisOrder = projAxisToWmsBbox(CRS.axisOrder(this.crs));
        } else {
            // Versions 1.X.X mandate long/lat order, east-north orientation
            this.axisOrder = 'wsen';
        }

        const crsPropName = (this.version === '1.3.0') ? 'CRS' : 'SRS';

        const urlObj = new URL(this.url);
        urlObj.searchParams.set('SERVICE', 'WMS');
        urlObj.searchParams.set('REQUEST', 'GetMap');
        urlObj.searchParams.set('LAYERS', this.name);
        urlObj.searchParams.set('VERSION', this.version);
        urlObj.searchParams.set('STYLES', this.style);
        urlObj.searchParams.set('FORMAT', this.format);
        urlObj.searchParams.set('TRANSPARENT', this.transparent);
        urlObj.searchParams.set('BBOX', '%bbox');
        urlObj.searchParams.set(crsPropName, this.crs);
        urlObj.searchParams.set('WIDTH', this.width);
        urlObj.searchParams.set('HEIGHT', this.height);

        this.vendorSpecific = vendorSpecific;
        for (const name in this.vendorSpecific) {
            if (Object.prototype.hasOwnProperty.call(this.vendorSpecific, name)) {
                urlObj.searchParams.set(name, this.vendorSpecific[name]);
            }
        }

        this.url = decodeURIComponent(urlObj.toString());
    }

    urlFromExtent(extentOrTile) {
        if (extentOrTile.isTile) {
            extentOrTile = extentOrTile.toExtent(this.crs, _extent);
        }
        return subDomains(bbox(extentOrTile, this));
    }

    getDataKey(extentOrTile) {
        if (extentOrTile.isTile) {
            return `z${extentOrTile.zoom}r${extentOrTile.row}c${extentOrTile.col}`;
        } else {
            return `z${extentOrTile.zoom}s${extentOrTile.south}w${extentOrTile.west}`;
        }
    }

    extentInsideLimit(extent) {
        return this.extent.intersectsExtent(extent);
    }
}

export default WMSSource;

1	import { Extent, CRS } from '@itowns/geographic';	1✔
2	import { bbox, subDomains } from 'Provider/URLBuilder';	1✔
3	import Fetcher from 'Provider/Fetcher';	1✔
4	import URLSource from './URLSource';	1✔
5		1✔
6	const _extent = new Extent('EPSG:4326');	1✔
7		1✔
8	/**	1✔
9	* Proj provides an optional param to define axis order and orientation for a	1✔
10	* given projection. 'enu' for instance stands for east, north, up.	1✔
11	* Elevation is not needed here. The two first characters are sufficient to map	1✔
12	* proj axis to iTowns bbox order formalism.	1✔
13	* 'enu' corresponds to 'wsen' because bbox starts by lower value coordinates	1✔
14	* and preserves axis ordering, here long/lat.	1✔
15	*/	1✔
16	const projAxisToBboxMappings = {	1✔
17	en: 'wsen',	1✔
18	es: 'wnes',	1✔
19	wn: 'eswn',	1✔
20	ws: 'enws',	1✔
21	ne: 'swne',	1✔
22	se: 'nwse',	1✔
23	nw: 'senw',	1✔
24	sw: 'nesw',	1✔
25	};	1✔
26		1✔
27	/**	1✔
28	* Provides the bbox axis order matching provided proj4 axis	1✔
29	* @param {string} projAxis the CRS axis order as defined in proj4	1✔
30	* @returns {string} the corresponding bbox axis order to use for WMS 1.3.0	1✔
31	*/	1✔
32	function projAxisToWmsBbox(projAxis) {	4✔
33	return projAxis && projAxisToBboxMappings[projAxis.slice(0, 2)] \|\| 'wsen';	4!
34	}	4✔
35		1✔
36	/**	1✔
37	* An object defining the source of images to get from a	1✔
38	* [WMS](http://www.opengeospatial.org/standards/wms) server. It inherits	1✔
39	* from {@link Source}.	1✔
40	*	1✔
41	* @extends Source	1✔
42	*	1✔
43	* @property {boolean} isWMSSource - Used to checkout whether this source is a	1✔
44	* WMSSource. Default is true. You should not change this, as it is used	1✔
45	* internally for optimisation.	1✔
46	* @property {string} name - The name of the layer, used in the generation of	1✔
47	* the url.	1✔
48	* @property {string} version - The version of the WMS server to request on.	1✔
49	* Default value is '1.3.0'.	1✔
50	* @property {string} style - The style to query on the WMS server. Default	1✔
51	* value is 'normal'.	1✔
52	* @property {number} width - The width of the image to fetch, in pixel.	1✔
53	* Default value is the height if set or 256.	1✔
54	* @property {number} height - The height of the image to fetch, in pixel.	1✔
55	* Default value is the width if set or 256.	1✔
56	* @property {string} axisOrder - The order of the axis, that helps building the	1✔
57	* BBOX to put in the url requesting a resource. Default value is 'wsen', other	1✔
58	* value can be 'swne'.	1✔
59	* @property {boolean} transparent - Tells if the image to fetch needs	1✔
60	* transparency support. Default value is false.	1✔
61	* @property {Object} zoom - Object containing the minimum and maximum values of	1✔
62	* the level, to zoom in the source.	1✔
63	* @property {number} zoom.min - The minimum level of the source. Default value	1✔
64	* is 0.	1✔
65	* @property {number} zoom.max - The maximum level of the source. Default value	1✔
66	* is 21.	1✔
67	* @property {string} bboxDigits - The bbox digits precision used in URL	1✔
68	* @property {Object} vendorSpecific - An object containing vendor specific	1✔
69	* parameters. See for example a [list of these parameters for GeoServer](	1✔
70	* https://docs.geoserver.org/latest/en/user/services/wms/vendor.html). This	1✔
71	* object is read simply with the `key` being the name of the parameter and	1✔
72	* `value` being the value of the parameter. If used, this property should be	1✔
73	* set in the constructor parameters.	1✔
74	*	1✔
75	* @example	1✔
76	* // Create the source	1✔
77	* const wmsSource = new itowns.WMSSource({	1✔
78	* url: 'https://server.geo/wms',	1✔
79	* version: '1.3.0',	1✔
80	* name: 'REGION.2016',	1✔
81	* style: '',	1✔
82	* crs: 'EPSG:3857',	1✔
83	* extent: {	1✔
84	* west: '-6880639.13557728',	1✔
85	* east: '6215707.87974825',	1✔
86	* south: '-2438399.00148845',	1✔
87	* north: '7637050.03850605',	1✔
88	* },	1✔
89	* transparent: true,	1✔
90	* });	1✔
91	*	1✔
92	* // Create the layer	1✔
93	* const colorlayer = new itowns.ColorLayer('Region', {	1✔
94	* source: wmsSource,	1✔
95	* });	1✔
96	*	1✔
97	* // Add the layer	1✔
98	* view.addLayer(colorlayer);	1✔
99	*/	1✔
100	class WMSSource extends URLSource {	1✔
101	/**	1✔
102	* @param {Object} source - An object that can contain all properties of	1✔
103	* WMSSource and {@link Source}. `url`, `name`, `extent` and `crs`	1✔
104	* are mandatory.	1✔
105	*/	1✔
106	constructor(source) {	1✔
107	const {	4✔
108	name,	4✔
109	extent,	4✔
110	crs,	4✔
111	format = 'image/png',	4✔
112	fetcher = Fetcher.get(format),	4✔
113	parser = ((d, opt) => { d.extent = opt.extent; return d; }),	4✔
114	style = '',	4✔
115	width = source.height \|\| 256,	4✔
116	height = source.width \|\| 256,	4✔
117	version = '1.3.0',	4✔
118	transparent = false,	4✔
119	bboxDigits,	4✔
120	axisOrder,	4✔
121	vendorSpecific,	4✔
122	} = source;	4✔
123		4✔
124	if (!name) {	4!
NEW 125	throw new Error('[WMSSource]: source.name is required.');	×
UNCOV 126	}	×
127		4✔
128	if (!extent) {	4!
NEW 129	throw new Error('[WMSSource]: source.extent is required');	×
UNCOV 130	}	×
131		4✔
132	if (!crs) {	4!
NEW 133	throw new Error('[WMSSource]: source.crs is required');	×
UNCOV 134	}	×
135		4✔
136	super({ ...source, fetcher, parser });	4✔
137		4✔
138	this.isWMSSource = true;	4✔
139	this.format = format;	4✔
140	this.name = name;	4✔
141	this.zoom = { min: 0, max: Infinity };	4✔
142	this.style = style;	4✔
143		4✔
144	this.width = width;	4✔
145	this.height = height;	4✔
146	this.version = version;	4✔
147	this.transparent = transparent;	4✔
148	this.bboxDigits = bboxDigits;	4✔
149		4✔
150	if (axisOrder) {	4!
NEW 151	this.axisOrder = axisOrder;	×
152	} else if (this.version === '1.3.0') { // If not set, axis order depends on WMS version	4✔
153	// Version 1.3.0 depends on CRS axis order as defined in epsg.org database	4✔
154	this.axisOrder = projAxisToWmsBbox(CRS.axisOrder(this.crs));	4✔
155	} else {	4!
156	// Versions 1.X.X mandate long/lat order, east-north orientation	×
157	this.axisOrder = 'wsen';	×
158	}	×
159		4✔
160	const crsPropName = (this.version === '1.3.0') ? 'CRS' : 'SRS';	4!
161		4✔
162	const urlObj = new URL(this.url);	4✔
163	urlObj.searchParams.set('SERVICE', 'WMS');	4✔
164	urlObj.searchParams.set('REQUEST', 'GetMap');	4✔
165	urlObj.searchParams.set('LAYERS', this.name);	4✔
166	urlObj.searchParams.set('VERSION', this.version);	4✔
167	urlObj.searchParams.set('STYLES', this.style);	4✔
168	urlObj.searchParams.set('FORMAT', this.format);	4✔
169	urlObj.searchParams.set('TRANSPARENT', this.transparent);	4✔
170	urlObj.searchParams.set('BBOX', '%bbox');	4✔
171	urlObj.searchParams.set(crsPropName, this.crs);	4✔
172	urlObj.searchParams.set('WIDTH', this.width);	4✔
173	urlObj.searchParams.set('HEIGHT', this.height);	4✔
174		4✔
175	this.vendorSpecific = vendorSpecific;	4✔
176	for (const name in this.vendorSpecific) {	4✔
177	if (Object.prototype.hasOwnProperty.call(this.vendorSpecific, name)) {	3✔
178	urlObj.searchParams.set(name, this.vendorSpecific[name]);	3✔
179	}	3✔
180	}	3✔
181		1✔
182	this.url = decodeURIComponent(urlObj.toString());	1✔
183	}	1✔
184		1✔
185	urlFromExtent(extentOrTile) {	1✔
186	if (extentOrTile.isTile) {	2!
NEW 187	extentOrTile = extentOrTile.toExtent(this.crs, _extent);	×
NEW 188	}	×
189	return subDomains(bbox(extentOrTile, this));	2✔
190	}	2✔
191		1✔
192	getDataKey(extentOrTile) {	1✔
193	if (extentOrTile.isTile) {	1✔
194	return `z${extentOrTile.zoom}r${extentOrTile.row}c${extentOrTile.col}`;	1✔
195	} else {	1!
NEW 196	return `z${extentOrTile.zoom}s${extentOrTile.south}w${extentOrTile.west}`;	×
NEW 197	}	×
198	}	1✔
199		1✔
200	extentInsideLimit(extent) {	1✔
201	return this.extent.intersectsExtent(extent);	3✔
202	}	3✔
203	}	1✔
204		1✔
205	export default WMSSource;	1✔

iTowns / itowns / 17292947856

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous