▾
Supported browsers
ArcGIS Maps SDK for JavaScript 5.2 supports the following browsers:
- Chrome 154 or later
- Edge 154 or later
- Firefox 159 or later
- Firefox 153 (ESR)
- iOS Safari 26 or later
- Safari 26 or later
For best performance use the latest versions of the browsers listed above.
Only WebGL2-enabled, 64-bit browsers are supported.
Minimum hardware requirements
- Desktop browsers - at least 8 GB system memory.
- Mobile devices - at least 4 GB system memory.
GPU hardware acceleration is important for rendering performance. Graphics hardware and drivers should be current and supported by the manufacturer. Systems without access to GPU hardware acceleration may fall back to software rendering and experience reduced performance.
For more information, see the FAQ
Virtualized environments
Within Virtual Desktop Infrastructure (VDI) and Remote Desktop Services (RDS) environments, each virtual desktop, machine or session must meet the minimum hardware requirements listed above per user. The following are recommendations for minimum performance:
- At least 2 virtual CPUs (vCPUs) per user.
- Use a physical GPU in the host server and allocate virtual GPU (vGPU) resources for each user.
- Use the client specifically designed for your VDI or Remote Desktop Connection (RDC).
- Run performance tests and periodically adjust the host server and client configurations for GIS workflows.
Feature-specific requirements
- SceneView
- Not supported on displays with a resolution above 4K
SDK classes and modules can have additional system requirements noted on a class-by-class basis in the API reference. For example, the Locate and Track components/widgets don’t work on insecure origins due to security considerations. The Fullscreen component/widget only works with browsers implementing the Fullscreen API. Thus, this feature is not supported on iOS Safari.
WebGL extensions
The API has the following features which require WebGL2 extensions that might not always be available in your browser:
To use these features with optimal visual quality, the extension EXT_color_buffer_float is required. For the HeatmapRenderer also OES_texture_float_linear is required. If any one of these extensions is not available, the HeatmapRenderer requires EXT_color_buffer_half_float instead to visualize any data in SceneView. For VoxelLayer the extension EXT_texture_norm16 is additionally required when displaying data of type INT16 or UINT16.
Devices missing the EXT_float_blend extension may render transparent and content using Symbol3DEmissive slightly different in some scenarios.
To test if a device supports these WebGL2 extensions, open https://webglreport.com on the device’s browser and check the extensions list.
npm
Make sure you are using the latest LTS version of node.js and npm.
Peer dependencies
The functionality of the SDK’s component packages depends on compatible versions of @arcgis/core and @esri/calcite-components, which are defined in a component’s package.json as peerDependencies.
These peer dependencies are installed by default when using npm as your preferred package manager:
- @arcgis/core: ^5.2
- @esri/calcite-components: ^5.2
Versioning
You may need to use specific dependency versions in your project. If so, install them manually and follow these versioning guidelines:
@arcgis/core: use a compatible minor version (e.g.,^)@esri/calcite-components: use a compatible minor version (e.g.,^)
Web server hosting configuration
The web server hosting configuration where you host the JavaScript Maps SDK will need the following MIME/type registration.
| extension | MIME/type | Description |
|---|---|---|
.ttf | application/octet-stream | True Type Fonts |
.wasm | application/wasm | WebAssembly |
.woff | application/font-woff | Web Open Font Format |
.woff2 | application/font-woff2 | WOFF File Format 2.0 |
.wsv | application/octet-stream | Supports SceneView’s stars visualization |
.pbf | application/x-protobuf | Fonts for MapView labeling for some layers |
Note that a web server supporting HTTPS requires the web server to use an SSL web server certificate.
Product Life Cycle
We recommend reviewing both the ArcGIS Maps SDK for JavaScript‘s Product Life Cycle page and the Developer Technologies section in the Esri Product Life Cycle Support Policy document. They contain detailed information on specific API version release dates and the associated product life cycle phases.