Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLCanvasElement : évènement webglcontextlost

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 ⁨juillet 2015⁩.

L'évènement webglcontextlost de l'API WebGL est déclenché si l'agent utilisateur détecte que le tampon de dessin associé à un objet WebGLRenderingContext a été perdu.

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.

js
addEventListener("webglcontextlost", (event) => { })

onwebglcontextlost = (event) => { }

Type d'évènement

Un WebGLContextEvent. Hérite de Event.

Event WebGLContextEvent

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

Avec l'aide de l'extension WEBGL_lose_context, vous pouvez simuler l'évènement webglcontextlost :

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");

canvas.addEventListener("webglcontextlost", (event) => {
  console.log(event);
});

gl.getExtension("WEBGL_lose_context").loseContext();

// L'évènement "webglcontextlost" est affiché dans la console.

Spécifications

Specification
WebGL Specification
# 5.15.2

Compatibilité des navigateurs

Voir aussi