recursal/MDN huggingface dataset:
Text
====

L'interface **`Text`** représente le contenu textuel d'un élément `Element` ou d'un attribut `Attr`. Si un élément n'a pas de balisage dans son contenu, il a un seul enfant implémentant `Text` qui contient le texte de l'élément. Par contre, si l'élément contient un balisage, il est analysé par les éléments d'information et les noeuds `Text` qui sont ses enfants.

Un nouveau document a un unique noeud `Text` pour chaque bloc de texte. Au fil du temps, d'autres noeuds peuvent être créés `Text` en temps que modification du contenu du document. La méthode `Node.normalize()` fusionne les objets `Text` dans un seul noeud pour chaque bloc de texte.

EventTarget

Node

CharacterData

TextConstructeur
------------

`Text()` (en-US) 
Expérimental

Retourne un noeud `Text` avec le paramètre comme contenu textuel.

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

*Hérite des propriétés de son parent `CharacterData`.*

`Text.isElementContentWhitespace` Lecture seule 
Obsolète

Renvoie une marque `Boolean` (en-US) indiquant si le noeud de texte contient uniquement des espaces.

`Text.wholeText` (en-US) Lecture seule 

Renvoie une `DOMString` (*chaîne de caractères*) contenant le texte de tous les noeuds `Text` adjacents logiquement à ce `Node`, concaténé dans l'ordre du document.

`Text.assignedSlot` (en-US) Lecture seule 

Retourne l'objet `HTMLSlotElement` associé à l'élément.

Méthodes
--------

*Hérite des méthodes de son parent `CharacterData`.*

`Text.replaceWholeText` (en-US) 
Obsolète

Remplace le texte du noeud en cours et tous les noeuds logiquement adjacents avec le texte spécifié.


`Text.splitText`

Fractionne le noeud en deux noeuds selon un décalage spécifié.

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

| Specification |
| --- |
| DOM Standard # interface-text |

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

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

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

* Référence du DOM
FormData
========

L'interface **`FormData`** permet de construire facilement un ensemble de paires clé/valeur représentant les champs du formulaire et leurs valeurs, qui peuvent ensuite être facilement envoyées en utilisant la méthode `XMLHttpRequest.send()` de l'objet `XMLHttpRequest`. Elle utilise le même format qu'utilise un formulaire si le type d'encodage est mis à `"multipart/form-data"`.

Vous pouvez également le passer directement au constructeur `URLSearchParams` si vous souhaitez générer des paramètres de requête de la même manière qu'un `<form>` le ferait s'il utilisait une simple soumission `GET`.

Un objet implémentant `FormData` peut être utilisé directement dans une structure `for…of`, au lieu de `entries()` : `for (var p of myFormData)` est équivalent à `for (var p of myFormData.entries())`.

**Note :** Cette fonctionnalité est disponible dans les Web Workers.

Constructeur
------------

`FormData()`

Crée un nouvel objet `FormData`.

Méthodes
--------

`FormData.append()`

Ajoute une nouvelle valeur à une clé existante dans un objet `FormData`, ou ajoute la clé si elle n'existe pas encore.

`FormData.delete()`

Supprime une paire clé/valeur d'un objet `FormData`.

`FormData.entries()`

Renvoie un itérateur permettant de passer en revue toutes les paires clé/valeur contenues dans cet objet.

`FormData.get()`

Renvoie la première valeur associée à une clé donnée à partir d'un objet `FormData`.

`FormData.getAll()`

Renvoie un tableau de toutes les valeurs associées à une clé donnée à partir d'un objet `FormData`.

`FormData.has()`

Renvoie un booléen indiquant si un objet `FormData` contient une certaine clé.

`FormData.keys()`

Renvoie un itérateur permettant de parcourir toutes les clés des paires clé/valeur contenues dans cet objet.

`FormData.set()`

Définit une nouvelle valeur pour une clé existante dans un objet `FormData`, ou ajoute la clé/valeur si elle n'existe pas encore.

`FormData.values()`

Renvoie un itérateur permettant de parcourir toutes les valeurs contenues dans cet objet.

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

| Specification |
| --- |
| XMLHttpRequest Standard # interface-formdata |

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

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

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

* `XMLHttpRequest`
* Utilisation de `XMLHttpRequest`
* Utilisation des objets `FormData`
* `<form>`
Plugin
======

L'interface `Plugin` fournit des informations à propos d'un plugin du navigateur.

**Note :** Les propriétés propres des objets `Plugin` ne sont plus énumérables dans les dernières versions des navigateurs.

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

`Plugin.description` Lecture seule 

Une description lisible du plugin.

`Plugin.filename` Lecture seule 

Le nom de fichier du fichier plugin.

`Plugin.name` Lecture seule 

Le nom du plugin.

`Plugin.version` Lecture seule 

Le numéro de version du plugin, en chaîne de caractères.

Méthodes
--------

`Plugin.item`

Renvoie le type MIME d'un type de contenu pris en charge, en fonction de l'index dans une liste de types pris en charge.

`Plugin.namedItem`

Renvoie le type MIME d'un élément pris en charge.

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

| Specification |
| --- |
| HTML Standard # dom-plugin |

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

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

`CSSStyleDeclaration` représente une collection de paires propriété/valeur CSS. Elle est utilisée dans quelques API :

* `HTMLElement.style` - pour manipuler le style d'un seul élément (<elem style="...">) ;
* L'API `CSSStyleSheet` (en-US). Par exemple, `document.styleSheets[0].cssRules[0].style` renvoie un objet `CSSStyleDeclaration` décrivant la première règle CSS dans la première feuille de style du document.
* `CSSStyleDeclaration` est également une interface en **lecture seule** pour le résultat de window.getComputedStyle().
Attributs
---------

`CSSStyleDeclaration.cssText`

Représentation textuelle du bloc de déclaration. La définition de cet attribut modifie le style.

`CSSStyleDeclaration.length` (en-US) Lecture seule 

Le nombre de propriétés. Voir la méthode `item()` (en-US) ci-dessous.

`CSSStyleDeclaration.parentRule` (en-US) Lecture seule 

Le contenant `CSSRule` (en-US).

Méthodes
--------

`CSSStyleDeclaration.getPropertyPriority()` (en-US)

Retourne la priorité facultative "important".

`CSSStyleDeclaration.getPropertyValue()` (en-US)

Retourne la valeur de la propriété avec un nom de propriété.

`CSSStyleDeclaration.item()` (en-US)

Retourne un nom de propriété.

`CSSStyleDeclaration.removeProperty()` (en-US)

Supprime une propriété du bloc de déclaration CSS.

`CSSStyleDeclaration.setProperty()` (en-US)

Modifie une propriété CSS existante ou crée une nouvelle propriété CSS dans le bloc de déclaration.

`CSSStyleDeclaration.getPropertyCSSValue()` (en-US) 
Obsolète

Uniquement supporté via getComputedStyle dans Firefox. Retourne la valeur de la propriété en tant que `CSSPrimitiveValue` (en-US) ou `null` pour les propriétés raccourcies.

Exemple
-------


```js
var objStyle = document.styleSheets[0].cssRules[0].style;
console.log(objStyle.cssText);

for (var i = objStyle.length; i--; ) {
  var chaineNom = objStyle[i];
  objStyle.removeProperty(chaineNom);
}

console.log(objStyle.cssText);
```

Notes
-----

Le bloc de déclaration est la partie de la règle de mise en forme qui apparaît dans les accolades et qui fournit les définitions de mise en forme (pour le sélecteur, la partie qui précède les accolades).

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

| Specification |
| --- |
| CSS Object Model (CSSOM) # the-cssstyledeclaration-interface |

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

* Référence des propriétés CSS
BatteryManager
==============

L'interface `BatteryManager` fournit des moyens pour obtenir des informations sur le niveau de charge de la batterie du système. La méthode `navigator.getBattery()` renvoie un objet `Promise` dont la valeur de résolution est une interface `BatteryManager`.

EventTarget

BatteryManagerPropriétés
----------

`BatteryManager.charging` Lecture seule 

Une valeur booléenne indiquant si la batterie est actuellement en cours de charge.

`BatteryManager.chargingTime` Lecture seule 

Un nombre qui représente le temps restant en secondes jusqu'à ce que la batterie soit complètement chargée, ou `0` si la batterie est complètement chargée.

`BatteryManager.dischargingTime` Lecture seule 

Un nombre qui représente le temps restant en secondes jusqu'à ce que la batterie soit complètement déchargée et le système suspendu.

`BatteryManager.level` Lecture seule 

Un nombre qui représente le niveau de charge de la batterie du système adapté à une valeur comprise entre `0.0` et `1.0`.

Méthodes
--------

*`BatteryManager` hérite des méthodes de son interface parente :* `EventTarget`.

Évènements
----------

`chargingchange` (en-US)

Se déclenche lorsque l'état de charge de la batterie (la propriété `charging`) est mis à jour.

`chargingtimechange` (en-US)

Se déclenche lorsque le temps de recharge de la batterie (la propriété `chargingTime`) est mis à jour.

`dischargingtimechange` (en-US)

Se déclenche lorsque le temps de décharge de la batterie (la propriété `dischargingTime`) est mis à jour.

`levelchange` (en-US)

Se déclenche lorsque le niveau de charge de la batterie (la propriété `level`) est mis à jour.

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

| Specification |
| --- |
| Battery Status API # the-batterymanager-interface |

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

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

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

* L'API *Battery Status*
* `navigator.getBattery()`
HTMLFormControlsCollection
==========================

L'interface **`HTMLFormControlsCollection`** représente une *collection* *d'éléments de contrôle de formulaires*. Il représente les listes retournées par le `HTMLFormElement` et le `HTMLFieldSetElement` (en-US) de la propriété d'interface `elements`.

Cette interface remplace une méthode de `HTMLCollection`, sur laquelle elle est basée.

HTMLCollection

HTMLFormControlsCollectionPropriétés
----------

*Cette interface hérite des propriétés de son parent `HTMLCollection`.*

Méthodes
--------

*Cette interface hérite des méthodes de son parent `HTMLCollection`.*

`HTMLFormControlsCollection.namedItem()` (en-US)

Renvoie la `RadioNodeList` (en-US) (*liste de noeuds radio*) ou l'`Element` dans la collection dont le `name` (*nom*) ou l'`id` (*identifiant*) correspond au nom spécifié, ou `null` si aucun noeud ne correspond. Noter que cette version de `namedItem()` cache celui hérité de `HTMLCollection`. Comme pour le premier, en JavaScript, en utilisant le crochet de la syntaxe de tableau (*array*) avec une `String` (*chaîne de caractères*), `collection["value"]` est équivalent à `collection.namedItem("value")`.

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

| Specification |
| --- |
| HTML Standard # htmlformcontrolscollection |

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

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

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

* `HTMLCollection`, `RadioNodeList` (en-US), `HTMLOptionsCollection` (en-US)
Gamepad API
===========

L'**API Gamepad** est un moyen pour les développeurs d'accéder aux signaux provenant des manettes des jeu et des autres unités de commande du jeu d'y répondre de manière simple et systématique. Il contient trois interfaces, deux événements et une fonction spécialisée, pour répondre aux manettes connectées et déconnectées, et pour accéder à d'autres informations sur les manettes elles-mêmes, ainsi que sur les boutons et autres commandes sur lesquels vous appuyez actuellement.

Interfaces
----------

`Gamepad`

Représente une manette de jeu / unités de commande du jeu connecté à l'ordinateur.

`GamepadButton` (en-US)

Représente un bouton sur un gamepad connecté.

`GamepadEvent` (en-US)

L'objet d'événement qui déclenche des événements sur la manette de jeu contiguë de manière représentative.

### Extensions de manette du jeu expérimentales

`GamepadHapticActuator` (en-US)

Represents hardware in the controller designed to provide haptic feedback to the user (if available), most commonly vibration hardware.

`GamepadPose` (en-US)

Represents the pose of a controller (e.g. position and orientation in 3D space) in the case of a WebVRcontroller.

See also the extensions to the Gamepad interface, for features that allow you to access the above information.

### Extensions à d'autres interfaces

#### Navigator

`Navigator.getGamepads()`

An extension to the `Navigator` object that returns an array of `Gamepad` objects, one for each connected gamepad.

#### Window events

`Window.ongamepadconnected` (en-US)

Represents an event handler that will run when a gamepad is connected (when the `gamepadconnected` event fires).

`Window.ongamepaddisconnected` (en-US)

Represents an event handler that will run when a gamepad is disconnected (when the `gamepadisdisconnected` event fires).

Tutoriels et guides
-------------------

* Using the Gamepad API
* Implementing controls using the Gamepad API (en-US)
Spécifications
--------------

| Specification |
| --- |
| Gamepad # gamepad-interface |
| Gamepad Extensions # partial-gamepad-interface |

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

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

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

* The Gamepad API by Ted Mielczarek and Robert Nyman
* Simple API demo page (source)
clearInterval()
===============

La méthode globale **`clearInterval()`** permet d'annuler une action répétée minutée initiée via un appel à `setInterval()` (en-US). Si le paramètre fourni ne permet pas d'identifier une action lancée précédemment, cette méthode n'a aucun effet.

Syntaxe
-------


```js
clearInterval(intervalID);
```

### Paramètres

`intervalID`

L'identifiant de l'intervalle de répétition qu'on souhaite annuler. Cet identifiant est renvoyé lorsqu'on appelle `setInterval()` pour définir l'intervalle de répétition.

On notera que l'ensemble des identifiants utilisés est commun entre ceux fournis par `setInterval()` (en-US) et ceux fournis par `setTimeout()`. Cela signifie qu'on peut, techniquement, utiliser `clearInterval()` et `clearTimeout()` (en-US) de façon interchangeable. C'est toutefois une mauvaise pratique, qui nuit à la lisibilité du code et à sa maintenabilité.

### Valeur de retour

Aucune (`undefined`).

Exemples
--------

Voir l'exemple `setInterval()` (en-US).

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

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

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

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

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

* `setTimeout`
* `setInterval` (en-US)
* `clearTimeout` (en-US)
* `Window.requestAnimationFrame`
CSSStyleRule
============

CSSStyleRule représente une règle de style CSS unique. Il implémente l'interface `CSSRule` (en-US) avec une valeur de type 1 (CSSRule STYLE\_RULE).

Syntaxe
-------

La syntaxe est décrite à l'aide du format WebIDL.
```

interface CSSStyleRule : CSSRule {
    attribute DOMString selectorText;
    readonly attribute CSSStyleDeclaration style;
};
```

Properties
----------

`CSSStyleRule.selectorText` (en-US)

Obtient la représentation textuelle du sélecteur pour cette règle, par exemple "H1, H2".

`CSSStyleRule.style` (en-US)

Retourne l'objet `CSSStyleDeclaration` pour cette règle.

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

| Specification |
| --- |
| CSS Object Model (CSSOM) # the-cssstylerule-interface |

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

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

L'objet `WebSocket` fournit l'API qui permet de créer et de gérer une connexion WebSocket à un serveur ainsi que d'envoyer et de recevoir des données sur cette connexion.

Pour construire un objet `WebSocket`, on utilisera le constructeur `WebSocket()`.

**Note:** Cette fonctionnalité est disponible via les Web Workers

Constructeur
------------

`WebSocket(url[, protocols])`

Renvoie un nouvel objet `WebSocket`.

Constantes
----------

|  |  |
| --- | --- |
| Constante | Valeur |
| `WebSocket.CONNECTING` | `0` |
| `WebSocket.OPEN` | `1` |
| `WebSocket.CLOSING` | `2` |
| `WebSocket.CLOSED` | `3` |

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

`WebSocket.binaryType`

Le type de données binaire utilisé par la connexion.

`WebSocket.bufferedAmount` Lecture seule 

Le nombre d'octets de données dans la queue.

`WebSocket.extensions` Lecture seule 

Les extensions sélectionnées par le serveur.

`WebSocket.onclose`

Un gestionnaire d'évènement à appeler lorsque la connexion est fermée.

`WebSocket.onerror`

Un gestionnaire d'évènement à appeler en cas d'erreur.

`WebSocket.onmessage`

Un gestionnaire d'évènement à appeler lors de la réception d'un message du serveur.

`WebSocket.onopen`

Un gestionnaire d'évènement à appeler lorsque la connexion est ouverte.

`WebSocket.protocol` Lecture seule 

Le sous-protocole sélectionné par le serveur.

`WebSocket.readyState` Lecture seule 

L'état courant de la connexion.

`WebSocket.url` Lecture seule 

L'URL absolue de la WebSocket.

Méthodes
--------

`WebSocket.close([code[, reason]])`

Ferme la connexion.

`WebSocket.send(data)`

Ajoute des données à transmettre à la queue.

Évènements
----------

`close`

Déclenché lorsqu'une connexion avec une `WebSocket` est fermée. Également disponible avec la propriété `onclose`.

`error`

Déclenché lorsqu'une connexion avec une `WebSocket` a été fermée à cause d'une erreur, par exemple lorsque des données n'ont pu être envoyées. Également disponible avec la propriété `onerror`.

`message`

Déclenché lorsque des données sont reçues via une `WebSocket`. Également disponible avec la propriété `onmessage`.

`open`

Déclenché lorsqu'une connexion avec une `WebSocket` est ouverte. Également disponible avec la propriété `onopen`.

Exemples
--------


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

// La connexion est ouverte
socket.addEventListener("open", function (event) {
  socket.send("Coucou le serveur !");
});

// Écouter les messages
socket.addEventListener("message", function (event) {
  console.log("Voici un message du serveur", event.data);
});
```

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

| Specification |
| --- |
| WebSockets Standard # the-websocket-interface |

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

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

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

* Écrire des applications clientes WebSocket
XMLSerializer
=============

`XMLSerializer` sert à convertir des sous-arborescence DOM ou des documents DOM en texte. `XMLSerializer` est accessible aux scripts sans privilèges.

**Note :** `XMLSerializer` sert le plus souvent aux applications et extensions basées sur la plateforme Mozilla. Bien qu'il soit utilisable par les pages Web, il ne fait partie d'aucun standard et son niveau de support dans les autres navigateurs est inconnu.

### Méthodes

serializeToString

Retourne la sous-arborescence sérialisée sous la forme d'une chaîne de caractères

serializeToStream

La sous-arborescence débutant par l'élément spécifié est sérialisée en un flux d'octets en utilisant l'encodage de caractères indiqué.

### Exemple


```js
var s = new XMLSerializer();
var d = document;
var str = s.serializeToString(d);
alert(str);
```



```js
var s = new XMLSerializer();
var stream = {
  close: function () {
    alert("Flux fermé");
  },
  flush: function () {},
  write: function (string, count) {
    alert("'" + string + "'\n nb d'octets&nbsp;: " + count + "");
  },
};
s.serializeToStream(document, stream, "UTF-8");
```

### Voir aussi

* Reference (en) (XULPlanet)
* Parsing and serializing XML
* Parsing and serializing XML (en) (XULPlanet)
* Parsing and serializing XML (en) (MozillaZine)
* XMLHttpRequest
* DOMParser
DeviceMotionEvent
=================

**Expérimental:** **Cette fonction est expérimentale**  
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.  
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

Résumé
------

`DeviceMotionEvent` fournit aux développeurs Web des informations sur la vitesse des changements de position et d'orientation de l'appareil.

**Attention :** Actuellement, Firefox et Chrome ne gèrent pas les coordonnées de la même manière. Faites attention à cela lorsque vous les utilisez.

Constructeur
------------

`DeviceMotionEvent.DeviceMotionEvent()`

Crée un nouvel `DeviceMotionEvent`.

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

`DeviceMotionEvent.acceleration` (en-US) Lecture seule 

Un objet donnant l'accélération du dispositif sur les trois axes X, Y et Z. L'accélération est exprimée en m/s2.

`DeviceMotionEvent.accelerationIncludingGravity` Lecture seule 

Un objet donnant l'accélération de l'appareil sur les trois axes X, Y et Z avec l'effet de la gravité. L'accélération est exprimée en m/s2.

`DeviceMotionEvent.rotationRate` Lecture seule 

Un objet donnant le taux de changement d'orientation de l'appareil sur les trois axes d'orientation alpha, bêta et gamma. Le taux de rotation est exprimé en degrés par seconde.

`DeviceMotionEvent.interval` Lecture seule 

Nombre représentant l'intervalle de temps, en millisecondes, auquel les données sont obtenues à partir de l'appareil.

Exemple
-------


```js
window.addEventListener("devicemotion", function (event) {
  console.log(event.acceleration.x + " m/s2");
});
```

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

| Specification |
| --- |
| DeviceOrientation Event Specification # devicemotion |

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

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

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

* L'évènement `deviceorientation`
* `DeviceOrientationEvent`
* L'évènement `devicemotion`
* `Accelerometer` (en-US)
* `LinearAccelerationSensor` (en-US)
* Détection de l'orientation de l'appareil (en-US)
* Explication des données d'orientation et de mouvement