aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/element/error_event/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/web/api/element/error_event/index.md')
-rw-r--r--files/fr/web/api/element/error_event/index.md144
1 files changed, 105 insertions, 39 deletions
diff --git a/files/fr/web/api/element/error_event/index.md b/files/fr/web/api/element/error_event/index.md
index f884e24cd0..664cfd66e2 100644
--- a/files/fr/web/api/element/error_event/index.md
+++ b/files/fr/web/api/element/error_event/index.md
@@ -1,54 +1,120 @@
---
-title: error
+title: 'Element : évènement error'
slug: Web/API/Element/error_event
-tags:
- - DOM
- - Erreurs
- - Gestionnaire d'erreurs
- - Interface
- - évènements
translation_of: Web/API/Element/error_event
original_slug: Web/Events/error
+browser-compat: api.Element.error_event
---
-L'événement **error** _(erreur)_ est déclenché lorsqu'une ressource n'a pas pu être chargée ; les circonstances exactes varient, ce nom étant utilisé par une grande variété d'API.
+{{APIRef}}
-## Informations générales
+L'évènement `error` est déclenché sur un objet [`Element`](/fr/docs/Web/API/Element) lorsque le chargement d'une ressource a échoué ou qu'elle ne peut pas être utilisée. Cela peut, par exemple, se produire lors d'une erreur d'exécution d'un script ou lorsqu'une image ne peut être trouvée ou si elle est invalide.
-- Spécification
- - : [DOM L3](http://www.w3.org/TR/DOM-Level-3-Events/#event-type-error)
-- Interface
- - : {{domxref("UIEvent")}} si généré depuis l'interface utilisateur, {{domxref("MediaRecorderErrorEvent")}} si généré par [MediaStream Recording API](/en-US/docs/Web/API/MediaStream_Recording_API) et sinon {{domxref("Event")}}.
-- Propagation
- - : Non
-- Annulable
- - : Non
-- Cible
- - : {{domxref("Element")}}
-- Action par défaut
- - : Aucune
+<table class="properties">
+ <tbody>
+ <tr>
+ <th scope="row">Bouillonnement</th>
+ <td>Non</td>
+ </tr>
+ <tr>
+ <th scope="row">Annulable</th>
+ <td>Non</td>
+ </tr>
+ <tr>
+ <th scope="row">Interface</th>
+ <td><a href="/fr/docs/Web/API/Event"><code>Event</code></a> ou <a href="/fr/docs/Web/API/UIEvent"><code>UIEvent</code></a></td>
+ </tr>
+ <tr>
+ <th scope="row">Propriété pour la gestion d'évènement</th>
+ <td>
+ <a href="/fr/docs/Web/API/GlobalEventHandlers/onerror"><code>onerror</code></a>
+ </td>
+ </tr>
+ </tbody>
+</table>
-## Propriétés
+L'objet évènement obtenu est une instance [`UIEvent`](/fr/docs/Web/API/UIEvent) s'il a été généré depuis un élément de l'interface utilisateur ou une instance [`Event`](/fr/docs/Web/API/Event) sinon.
-| Property | Type | Description |
-| ------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
-| `target` {{readonlyInline}} | [`EventTarget`](/en-US/docs/Web/API/EventTarget) | The event target (the topmost target in the DOM tree). |
-| `type` {{readonlyInline}} | [`DOMString`](/en-US/docs/Web/API/DOMString) | The type of event. |
-| `bubbles` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event normally bubbles or not. |
-| `cancelable` {{readonlyInline}} | [`Boolean`](/en-US/docs/Web/API/Boolean) | Whether the event is cancellable or not. |
-| `view` {{readonlyInline}} | [`WindowProxy`](/en-US/docs/Web/API/WindowProxy) | [`document.defaultView`](/en-US/docs/Web/API/Document/defaultView) (`window` of the document) |
-| `detail` {{readonlyInline}} | `long` (`float`) | 0. |
+## Exemples
-### Pour des évènements MediaStream Recording
+### HTML
-Ces évènements sont d'un type {{domxref("MediaRecorderErrorEvent")}}.
+```html
+<div class="controls">
+ <button id="img-error" type="button">Générer une erreur d'image</button>
+ <img class="bad-img" />
+</div>
-{{page("/en-US/docs/Web/API/MediaRecorderErrorEvent", "Properties")}}
+<div class="event-log">
+ <label>Journal d'évènements :</label>
+ <textarea readonly class="event-log-contents" rows="8" cols="30"></textarea>
+</div>
+```
+
+```css hidden
+body {
+ display: grid;
+ grid-template-areas: "control log";
+}
+
+.controls {
+ grid-area: control;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+}
+
+.event-log {
+ grid-area: log;
+}
+
+.event-log-contents {
+ resize: none;
+}
+
+label, button {
+ display: block;
+}
+
+button {
+ height: 2rem;
+ margin: .5rem;
+}
+
+img {
+ width: 0;
+ height: 0;
+}
+```
+
+### JS
+
+```js
+const log = document.querySelector('.event-log-contents');
+
+const badImg = document.querySelector('.bad-img');
+badImg.addEventListener('error', (event) => {
+ log.textContent = log.textContent + `${event.type}: Chargement de l'image\n`;
+ console.log(event)
+});
+
+const imgError = document.querySelector('#img-error');
+imgError.addEventListener('click', () => {
+ badImg.setAttribute('src', 'i-dont-exist');
+});
+```
+
+### Résultat
+
+{{EmbedLiveSample('', '100%', '250px')}}
+
+## Spécifications
+
+{{Specifications}}
+
+## Compatibilité des navigateurs
+
+{{Compat}}
## Voir aussi
-- {{domxref("GlobalEventHandlers.onerror")}}
- - : Évènements envoyés à {{domxref("Window.onerror")}} et à {{domxref("Element.onerror")}}
-- {{domxref("HTMLMediaElement.onerror")}}
- - : Évènements envoyés à {{domxref("HTMLMediaElement")}} incluant {{HTMLElement("audio")}} et {{HTMLElement("video")}} .
-- {{domxref("MediaRecorder.onerror")}}
- - : Évènements envoyés à {{domxref("MediaRecorder.onerror")}} , d'un type {{domxref("MediaRecorderErrorEvent")}}
+- L'évènement correspondant pour les cibles `Window`&nbsp;: [`error`](/fr/docs/Web/API/Window/error_event)