recursal/MDN huggingface dataset:
WebSocket : évènement message
=============================

L'évènement `message` est déclenché lorsque des données sont reçues via une `WebSocket`.

|  |  |
| --- | --- |
| Bouillonne/Remonte | Non |
| Annulable | Non |
| Interface | `MessageEvent` |
| Propriété de gestionnaire d'évènement correspondante | `onmessage` |

Exemples
--------


```js
// Crée une connexion WebSocket
const socket = new WebSocket("ws://localhost:8080");

// Écoute les différents messages
socket.addEventListener("message", function (event) {
  console.log("Message reçu du serveur ", event.data);
});
```

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # dom-websocket-onmessage |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* WebSocket : évènement `close`
* WebSocket : évènement `error`
* WebSocket : évènement `open`
* Écrire des applications clientes WebSocket
WebSocket.protocol
==================

La propriété en lecture seule **`WebSocket.protocol`** renvoie le nom du sous protocole sélectionné par le serveur. Cette valeur sera l'une des chaînes de caractères du paramètre `protocols` utilisé lors de la création de l'objet `WebSocket` ou la chaîne vide si aucune connexion n'est établie.

Syntaxe
-------


```js
var protocol = uneWebSocket.protocol;
```

Valeur
------

Une chaîne de caractères `DOMString`.

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # ref-for-dom-websocket-protocol① |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
WebSocket.bufferedAmount
========================

La propriété en lecture seule **`WebSocket.bufferedAmount`** renvoie le nombre d'octets de données qui ont été placées dans la queue via des appels à `send()` mais qui n'ont pas encore été transmises sur le réseau. Cette valeur est réinitialisée à zéro lorsque toutes les données ont été envoyées. Cette valeur n'est pas remise à zéro lorsque la connexion est fermée. Des appels successifs à `send()` feront croître cette valeur.

Syntaxe
-------


```js
var bufferedAmount = aWebSocket.bufferedAmount;
```

Valeur
------

Un nombre au format `unsigned long`.

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # ref-for-dom-websocket-bufferedamount① |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
WebSocket.close()
=================

La méthode **`WebSocket.close()`** ferme la connexion `WebSocket` ou interrompt l'éventuelle tentative de connexion. Si la connexion est déjà fermée (état `CLOSED`), cette méthode ne fait rien.

Syntaxe
-------


```js
WebSocket.close();
```



```js
WebSocket.close(code);
```



```js
WebSocket.close(reason);
```



```js
WebSocket.close(code, reason);
```

### Paramètres

`code` Facultatif

Une valeur numérique indiquant le code de statut qui explique pourquoi la connexion est fermée. Si ce paramètre n'est pas fourni, 1005 sera la valeur par défaut. Voir la liste des codes de statut de `CloseEvent` pour les valeurs autorisées.

`reason` Facultatif

Une chaîne de caractères, lisible et compréhensible par un humain qui explique pourquoi la connexion est fermée. Cette chaîne ne doit pas être plus longue que 123 octets de texte UTF-8 (attention, **cela ne signifie pas** 123 caractères).

### Exceptions levées

`INVALID_ACCESS_ERR`

Un code invalide a été fourni avec `code`.

`SYNTAX_ERR`

La chaîne de caractères pour `reason` est trop longue ou contient des

*surrogates*

non appairés.


**Note :** Avant Gecko 8.0, cette méthode ne prenait en charge aucun paramètre.

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # ref-for-dom-websocket-close① |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
WebSocket : évènement close
===========================

L'évènement `close` est déclenché lorsqu'une connexion avec une `WebSocket` est fermée.

|  |  |
| --- | --- |
| Bouillonne/Remonte | Non |
| Annulable | Non |
| Interface | `CloseEvent` |
| Propriété de gestionnaire d'évènement correspondante | `onclose` |

Exemples
--------

On peut vouloir savoir lorsque la connexion a été fermée afin de mettre à jour l'interface utilisateur ou, éventuellement, pour sauvegarder des données à propos de la connexion. Soit une variable `socketExemple` qui fait référence à une connexion WebSocket ouverte, le fragment de code suivant gère la situation où la socket a été fermée :


```js
socketExemple.addEventListener("close", (event) => {
  console.log("La connexion a été fermée avec succès.");
});
```


On peut effectuer les mêmes actions avec la propriété de gestion d'évènement correspondante :


```js
socketExemple.onclose = function (event) {
  console.log("La connexion a été fermée avec succès.");
};
```

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # dom-websocket-onclose |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* WebSocket : évènement `error`
* WebSocket : évènement `message`
* WebSocket : évènement `open`
* Écrire des applications clientes WebSocket
WebSocket.url
=============

La propriété en lecture seule **`WebSocket.url`** renvoie l'URL absolue de la `WebSocket` telle que résolue par le constructeur.

Syntaxe
-------


```js
var url = aWebSocket.url;
```

Valeur
------

Une chaîne de caractères `DOMString`.

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # ref-for-dom-websocket-url① |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
WebSocket.extensions
====================

La propriété en lecture seule **`WebSocket.extensions`** renvoie les extensions sélectionnées par le serveur. Actuellement, cette propriété vaut une chaîne de caractères vide ou la liste des extensions négociées par la connexion.

Syntaxe
-------


```js
var extensions = aWebSocket.extensions;
```

Valeur
------

Une chaîne de caractères `DOMString`.

Spécifications
--------------

| Specification |
| --- |
| WebSockets Standard # ref-for-dom-websocket-extensions① |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window.screenX
==============

La propriété **`Window.screenX`** retourne la distance honrizontale, in CSS pixels, of the left border of the user's browser from the left side of the screen.

Syntaxe
-------


```js
lLoc = window.screenX;
```


* *`lLoc`* is the number of CSS pixels from the left side the screen.
Spécifications
--------------

| Specification |
| --- |
| CSSOM View Module # dom-window-screenx |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `window.screenLeft` (en-US)
* `Window.screenY` (en-US)
Window.blur()
=============

Éloigne la mise au point de la fenêtre.

Syntaxe
-------


```js
window.blur();
```

Exemple
-------


```js
window.blur();
```

Notes
-----

La méthode `window.blur()` est l'équivalent programmatique du déplacement du focus de l'utilisateur loin de la fenêtre courante.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-window-blur |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window: storage event
=====================

L'événement **`storage`** de l'interface `Window` se déclenche lorsqu'une de stockage (`localStorage`) a été modifiée dans le contexte d'un autre document.

| Bulles | Non |
| Annulable | Non |
| Interface | `StorageEvent` (en-US) |
| Propriété de gestionnaire d'événements | `onstorage` (en-US) |

Exemples
--------

Consignez l'élément `sampleList` sur la console lorsque l'événement `storage` se déclenche :


```js
window.addEventListener("storage", () => {
  // Lorsque le stockage local change, vider la liste sur
  // la console.
  console.log(JSON.parse(window.localStorage.getItem("sampleList")));
});
```


La même action peut être réalisée ) l'aide de la propriété du gestionnaire d'événements `onstorage` (en-US) :


```js
window.onstorage = () => {
  // Lorsque le stockage local change, vider la liste dans
  // la console.
  console.log(JSON.parse(window.localStorage.getItem("sampleList")));
};
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # event-storage |
| HTML Standard # handler-window-onstorage |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Web Storage API
* Using the Web Storage API
Window.showModalDialog()
========================

**Obsolète:** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

**Attention :** Cette fonctionnalité a été retirée. Veuillez corriger les sites ou applications web sous votre responsabilité qui l'utiliseraient encore.

Cette méthode a été retirée avec Chrome 43 et Firefox 56.

La méthode **`Window.showModalDialog()`** permettait de créer et d'afficher une boîte de dialogue modale contenant un document HTML indiqué.

Syntaxe
-------


```js
showModalDialog(uri);
showModalDialog(uri, arguments);
showModalDialog(uri, arguments, options);
```

### Paramètres

`uri`

L'URL du document à afficher dans la boîte de dialogue.

`arguments` Facultatif

Les valeurs passées comme propriétés à la boîte de dialogue.

`options` Facultatif

Une chaîne de caractères indiquant l'aspect de l'interface utilisateur pour la boîte de dialogue en utilisant une ou plusieurs valeurs, séparées par des points-virgules :



| Syntaxe | Description |
| --- | --- |
| `center: {on | off | yes | no | 1 | 0 }` | Si la valeur est `on`, `yes`, ou `1`, la boîte de dialogue est centrée à l'écran. Sinon, elle est cachée. La valeur par défaut est `yes`. |
| `dialogheight: *height*` | La hauteur de la boîte de dialogue, exprimée en pixels. |
| `dialogleft: *left*` | La distance de la boîte de dialogue par rapport au bord gauche de l'écran. |
| `dialogwidth: *width*` | La largeur de la boîte de dialogue, exprimée en pixels. |
| `dialogtop: *top*` | La distance de la boîte de dialogue par rapport au bord haut de l'écran. |
| `resizable: {on | off | yes | no | 1 | 0 }` | Si cet argument vaut `on`, `yes`, ou `1`, la fenêtre de la boîte de dialogue peut être redimensionnée, sinon sa taille est fixe. La valeur par défaut est `no`. |
| `scroll: {on | off | yes | no | 1 | 0 }` | Si cet argument vaut `on`, `yes`, ou `1`, la boîte de dialogue dispose de barres de défilement, sinon sa taille est fixe. La valeur par défaut est `no`. |

**Note :** Firefox n'implémente pas les arguments `dialogHide`, `edge`, `status`, ou `unadorned`.

### Valeur de retour

Contient la propriété `returnValue` telle que définie par le document ciblé par `uri`.

Notes
-----

`showModalDialog()` fut brièvement standardisée en HTML5. Le troisième argument pour les options additionnelles ne faisait pas partie de la version HTML5.

Spécifications
--------------

* MSDN page
for `showModalDialog`
Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `<dialog>` qui remplace `window.showModalDialog()`.
* Une prothèse d'émulation pour `showModalDialog()` qui utilise `<dialog>` et les générateurs
GlobalEventHandlers.onblur
==========================

La propriété **`onblur`**, rattachée au mixin `GlobalEventHandlers`, est le gestionnaire d'évènements (en-US) qui permet de traiter les évènements `blur` (en-US). Elle est disponible sur les interfaces `Element`, `Document`, et `Window`.

L'évènement `blur` est déclenché lorsqu'un élément perd le focus.

**Note :** Le gestionnaire d'évènement opposé à `onblur` est `onfocus`.

Syntaxe
-------


```js
cible.onblur = refFonction;
```

### Valeur

`refFonction` est un nom de fonction ou une expression de fonction. La fonction reçoit un objet `FocusEvent` comme unique argument.

Exemple
-------

Cet exemple utilise `onblur` et `onfocus` pour changer le texte au sein d'un élément `<input>`.

### HTML


```html
<input type="text" value="Cliquez ici" />
```

### JavaScript


```js
let input = document.querySelector("input");

input.onblur = inputBlur;
input.onfocus = inputFocus;

function inputBlur() {
  input.value = "Le focus a été perdu";
}

function inputFocus() {
  input.value = "Le focus est là";
}
```

### Résultat

Essayez de cliquer à l'intérieur et en dehors du champ pour voir son contenu être modifié.

Spécifications
--------------

| Specification |
| --- |
| UI Events # event-type-blur |
| HTML Standard # handler-onblur |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'évènement `blur` (en-US)
* Le gestionnaire d'évènement dual : `GlobalEventHandlers.onfocus`
window.prompt
=============

La méthode `Window.prompt()` affiche une boîte de dialogue, éventuellement avec un message, qui invite l'utilisateur à saisir un texte.

Syntaxe
-------


```js
résultat = window.prompt(message, défaut);
```

### Paramètres

`message` Facultatif

Une chaîne de caractères qui sera affichée pour l'utilisateur. Cet argument peut ne pas être utilisé s'il n'y a rien à afficher dans la fenêtre.

`default` Facultatif

Une chaîne de caractères contenant la valeur par défaut affichée pour la saisie. Pour Internet Explorer 7 et 8, si cet argument n'est pas fourni, ce sera la chaîne de caractères `"undefined"` qui sera la valeur par défaut.

### Valeur de retour

La chaîne de caractères qui a été saisie par l'utilisateur ou `null`.

Exemples
--------


```js
let signe = prompt("Quel est votre signe astrologique ?");

if (signe.toLowerCase() == "verseau") {
  console.log("Oh ? moi aussi je suis verseau :)");
}

// Différentes façons d'utiliser prompt
signe = window.prompt(); // ouvre une fenêtre de saisie sans texte
signe = prompt(); // ouvre une fenêtre de saisie sans texte

// ouvre une fenêtre avec le texte "Quelle est la réponse ?"
signe = window.prompt("Quelle est la réponse ?");

// ouvre une fenêtre avec le texte "Quelle est la réponse ?"
// avec la valeur "42" comme réponse par défaut
signe = window.prompt("Quelle est la réponse ?", "42");
```


Lorsque l'utilisateur clique sur le bouton OK, le texte saisi dans le champ est renvoyé par la fonction. Si l'utilisateur clique sur OK sans avoir saisi de texte, c'est la chaîne vide qui est renvoyée. Si l'utilisateur clique sur le bouton "Annuler", la fonction renvoie `null`.

Notes
-----

Une boîte de dialogue contient un texte sur une ligne, un bouton "Annuler" ainsi qu'un bouton "OK". Elle permet de renvoyer le texte (éventuellement vide) saisi par l'utilisateur dans le champ de saisie.

The following text is shared between this article, `DOM:window.confirm` and `DOM:window.alert`. Les boîtes de dialogue sont des fenêtres modales : elles empêchent l'utilisateur d'accéder au reste de l'interface du programme tant que la fenêtre n'est pas fermée. Pour ces raisons, mieux vaut ne pas abuser des fonctions qui créent de telles boîtes de dialogue et autres fenêtres modales.

On notera que le résultat de la fonction est une chaîne de caractères. Cela signifie qu'il faut parfois convertir la valeur founie par l'utilisateur. Si, par exemple, on souhaite que la réponse soit un nombre, il faudra la convertir (avec le constructeur `Number` éventuellement).


```js
const aNumber = Number(window.prompt("Veuillez saisir un nombre.", ""));
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-prompt-dev |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `alert`
* `confirm`
pageshow
========

L'évènement `pageshow` est émis lorsqu'une entrée dans un historique de session est atteinte (cela comprend les boutons précédent / suivant ainsi que l'affichage initial de la page après l'évènement `onload`).

Informations générales
----------------------

Spécification

HTML5

Interface

PageTransitionEvent

Bouillonne

Non

Annulable

Non

Cible

Document (dispatché sur Window)

Action par défaut

Aucune

Propriétés
----------

| Propriété | Type | Description |
| --- | --- | --- |
| `target` Lecture seule  | `EventTarget` | La cible de l'évènement (la plus haute dans l'arbre DOM). |
| `type` Lecture seule  | `DOMString` | Le type d'évènement. |
| `bubbles` Lecture seule  | `Boolean` | Si l'évènement bouillonne en temps normal ou non. |
| `cancelable` Lecture seule  | `Boolean` | Si l'évènement est annulable ou non. |
| `persisted` Lecture seule  | `boolean` | Si l'entrée est chargée depuis le cache ou non. |

Exemples
--------

L'exemple suivant va afficher dans la console des informations sur l'évènement `pageshow`, qui est émis à l'utilisation des boutons précédent / suivant, et pas uniquement après `onload` :


```js
window.addEventListener("pageshow", function (event) {
  console.log("pageshow:");
  console.log(event);
});
```


Bien que ce ne soit pas la meilleure pratique, vous pouvez également ajouter l'évènement comme un attribut sur la balise `<body>`, de la même manière que `onload` :


```html
<body onload="myonload()" onpageshow="mypageshowcode()"></body>
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # event-pageshow |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `pagehide`
Window: cut event
=================

L'événement **`cut`** est déclenché lorsque l'utilisateur a lancé une action de "cut" via l'interface utilisateur du navigateur.

|  |  |
| --- | --- |
| Bulles | Oui |
| Annulable | Oui |
| Interface | `ClipboardEvent` (en-US) |
| Propriété de gestionnaire d'événements | `oncut` (en-US) |

La cible d'origine de cet événement est le `Element` qui était la cible prévue de l'action cut. Vous pouvez écouter cet événement sur l'interface `Window` pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur l'événement Element: cut event (en-US).

Exemples
--------


```js
window.addEventListener("cut", (event) => {
  console.log("cut action initiated");
});
```

Spécifications
--------------

| Specification |
| --- |
| Clipboard API and events # clipboard-event-cut |
| HTML Standard # handler-oncut |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Événements liés: `copy`, `paste`
* Cet événement sur `Element` targets: `cut` (en-US)
* Cet événement sur `Document` targets: `cut` (en-US)
Window.fullScreen
=================

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

La propriété **`fullScreen`**, rattachée à l'interface `Window`, indique si la fenêtre est affichée en mode plein écran ou non.

Avec des privilèges sur le chrome, cette propriété est accessible en lecture-écriture, sinon elle est uniquement accessible en lecture. Il faut garder à l'esprit que tenter de modifier cette propriété sans disposer des privilèges sur le chrome ne déclenchera pas d'exception mais échouera silencieusement. Ce comportement évite de casser les scripts qui modifient cette propriété pour Internet Explorer.

Valeur
------

Une valeur booléenne qui indique si la fenêtre est en plein écran.

Notes
-----

* Passer entre le mode normal et le mode plein écran déclenchera l'évènement `resize` sur la fenêtre correspondante.
Exemples
--------


```js
if (window.fullScreen) {
  // en plein écran !
} else {
  // pas en plein écran !
}
```

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window.navigator
================

La propriété en lecture-seule **`Window.navigator`** renvoie une référence à un objet qui est une instance de `Navigator` et possède des méthodes et propriétés à propos de l'application qui exécute le script.

Syntaxe
-------


```js
navigatorObject = window.navigator;
```

Exemple
-------


```js
var sUsrAg = navigator.userAgent;
console.log("Voici l'agent utilisateur du navigateur courant", sUsrAg);
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-navigator |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window.outerWidth
=================

`Window.outerWidth` récupère la largeur de l'extérieur de la fenêtre du navigateur. Elle représente la largeur de toute la fenêtre du navigateur, y compris la barre latérale (si elle est agrandie), la fenêtre chrome et le redimensionnement de la fenêtre.

Cette propriété est en lecture seule ; elle n'a pas de valeur par défaut.

Syntaxe
-------


```js
largeurExterieureFenetre = window.outerWidth;
```


Lors du retour, `largeurExterieureFenetre` vaut la largeur de l'extérieur de la fenêtre.

Notes
-----

Pour changer la taille d'une fenêtre, voir `window.resizeBy()` et `window.resizeTo ()`.

Pour récupérer la largeur interne d'une fenêtre, c'est-à-dire la largeur de la page affichée, voir `window.innerWidth`.

Spécifications
--------------

| Specification |
| --- |
| CSSOM View Module # dom-window-outerwidth |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `window.outerHeight`, `window.innerHeight`, `window.innerWidth`
* `window.resizeBy()`, `window.resizeTo()` (en-US)