Skip to content

Check if WebGL is supported

Check for WebGL browser support.

import * as maplibregl from 'https://unpkg.com/maplibre-gl@6.2.0/dist/maplibre-gl.mjs';

const map = new maplibregl.Map({
    container: 'map',
    style: 'https://demotiles.maplibre.org/style.json',
    center: [-74.5, 40],
    zoom: 2
});
map.on('error', (e) => {
    if (e.error instanceof maplibregl.GPUInitializationError) {
        // You can also display the error message in the UI
        // This does not have to be an alert..
        alert(e.error.message);
        return;
    }
    // Don't forget to log the error to the console
    // We won't log it for you if you handle it
    console.error(e.error);
});

<!DOCTYPE html>
<html lang="en">
<head>
    <title>Check if WebGL is supported</title>
    <meta property="og:description" content="Check for WebGL browser support." />
    <meta property="og:category" content="Getting Started" />
    <meta property="og:created" content="2025-06-25" />
    <meta charset='utf-8'>
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <link rel='stylesheet' href='https://unpkg.com/maplibre-gl@6.2.0/dist/maplibre-gl.css' />

    <style>
        body { margin: 0; padding: 0; }
        html, body, #map { height: 100%; }
    </style>
</head>
<body>
<div id="map"></div>

<script type="module">
    import * as maplibregl from 'https://unpkg.com/maplibre-gl@6.2.0/dist/maplibre-gl.mjs';

    const map = new maplibregl.Map({
        container: 'map',
        style: 'https://demotiles.maplibre.org/style.json',
        center: [-74.5, 40],
        zoom: 2
    });
    map.on('error', (e) => {
        if (e.error instanceof maplibregl.GPUInitializationError) {
            // You can also display the error message in the UI
            // This does not have to be an alert..
            alert(e.error.message);
            return;
        }
        // Don't forget to log the error to the console
        // We won't log it for you if you handle it
        console.error(e.error);
    });
</script>
</body>
</html>