HTMLCanvasElement : évènement contextlost
Limited availability
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
L'évènement contextlost de l'API Canvas est déclenché si l'agent utilisateur détecte que le stockage, associé à un contexte CanvasRenderingContext2D, est perdu.
Les contextes peuvent être perdus pour plusieurs raisons, par exemple un plantage du pilote ou une saturation de la mémoire de l'application.
Par défaut, l'agent utilisateur tentera de restaurer le contexte, puis déclenchera l'évènement contextrestored.
Le code utilisateur peut empêcher la restauration du contexte en appelant Event.preventDefault() lors du traitement de l'évènement.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété gestionnaire d'évènements.
addEventListener("contextlost", (event) => { })
oncontextlost = (event) => { }
Type d'évènement
Un Event générique.
Exemple
Le fragment de code ci‑dessous détecte l'évènement contextlost.
const canvas = document.getElementById("canvas");
canvas.addEventListener("contextlost", (event) => {
console.log(event);
});
Pour empêcher la restauration du contexte, le code peut ressembler à ceci :
const canvas = document.getElementById("canvas");
canvas.addEventListener("contextlost", (event) => {
event.preventDefault();
});
Spécifications
| Specification |
|---|
| HTML # event-contextlost |