HTMLCanvasElement : évènement webglcontextcreationerror
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2016.
L'évènement webglcontextcreationerror de l'API WebGL est déclenché si l'agent utilisateur ne parvient pas à créer un contexte WebGLRenderingContext.
Cet évènement possède une propriété WebGLContextEvent.statusMessage, qui peut contenir une chaîne de caractères dépendant de la plateforme avec plus d'informations sur l'échec.
Cet évènement ne se propage pas.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété gestionnaire d'évènement.
addEventListener("webglcontextcreationerror", (event) => { })
onwebglcontextcreationerror = (event) => { }
Type d'évènement
Un WebGLContextEvent. Hérite de Event.
Propriétés de l'évènement
Cette interface hérite des propriétés de son interface parente, Event.
WebGLContextEvent.statusMessage-
Une propriété en lecture seule contenant des informations supplémentaires sur l'évènement.
Exemple
const canvas = document.getElementById("canvas");
canvas.addEventListener("webglcontextcreationerror", (e) => {
console.log(e.statusMessage || "Unknown error");
});
const gl = canvas.getContext("webgl");
// affiche statusMessage ou "Unknown error" si la création du contexte WebGL échoue
Spécifications
| Specification |
|---|
| WebGL Specification # 5.15.4 |
Compatibilité des navigateurs
Voir aussi
- L'interface
WebGLContextEvent - La méthode
WebGLRenderingContext.isContextLost() - L'extension
WEBGL_lose_contextet ses méthodesWEBGL_lose_context.loseContext(),WEBGL_lose_context.restoreContext()