recursal/MDN huggingface dataset:
NotificationEvent
=================

**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.

L'interface **`NotificationEvent`** représente un évènement de clic pour une notification et qui est dispatché vers le `ServiceWorkerGlobalScope` (en-US) d'un `ServiceWorker`.

Cette interface hérite de l'interface `ExtendableEvent`.

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

`NotificationEvent.NotificationEvent()` (en-US)

Cette méthode permet de créer un nouvel objet `NotificationEvent`.

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

*Cet objet hérite de propriétés grâce à son ancêtre : `Event`*.

`NotificationEvent.notification` (en-US) Lecture seule 

Cette propriété renvoie un objet `Notification` représentant la notification sur laquelle on a cliqué pour déclencher l'évènement.

`NotificationEvent.action` (en-US) Lecture seule 

Cette propriété renvoie une chaîne de caractères identifiant le bouton de la notification sur lequel l'utilisateur a cliqué. Cette valeur sera `undefined` si l'utilisateur a cliqué autre part que sur le bouton pour la notification ou si la notification ne possède pas de bouton.

Méthodes
--------

*Cet objet hérite de méthodes grâce à son parent* *`ExtendableEvent`*.

`ExtendableEvent.waitUntil()` (en-US)

Cette méthode allonge la durée de vie de l'évènement et indique qu'une tâche est toujours en cours.

Exemples
--------


```js
self.addEventListener("notificationclick", function (event) {
  console.log("Au clic sur la notification : ", event.notification.tag);
  event.notification.close();

  // On regarde ici si elle est déjà ouverte
  // et si le focus est dessus
  event.waitUntil(
    clients
      .matchAll({
        type: "window",
      })
      .then(function (clientList) {
        for (var i = 0; i < clientList.length; i++) {
          var client = clientList[i];
          if (client.url == "/" && "focus" in client) return client.focus();
        }
        if (clients.openWindow) return clients.openWindow("/");
      }),
  );
});
```

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

| Specification |
| --- |
| Notifications API Standard # notificationevent |

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

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

**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.

**Force Touch events** est une fonctionnalité propriétaire propre à Apple et qui rend possibles (si supporté par le matériel d'entrée) de nouvelles interactions basées sur le fait que l'utilisateur clique ou appuie sur l'écran tactile ou sur le trackpad.

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

`webkitmouseforcewillbegin` (en-US) 
Non-standard

Cet évènement est lancé avant l'évènement `mousedown`. Son utilisation principale est de permettre `Event.preventDefault()`.

`webkitmouseforcedown` (en-US) 
Non-standard

Cet évènement est lancé après l'évènement `mousedown` dès qu'une pression suffisante a été appliquée pour qu'il puisse être qualifié de "clic de force".

`webkitmouseforceup` (en-US) 
Non-standard

Cet évènement est lancé après l'évènement `webkitmouseforcedown` (en-US) dès que la pression a été suffisamment réduite pour terminer le "clic de force".

`webkitmouseforcechanged` (en-US) 
Non-standard

Cet évènement est lancé chaque fois que la quantité de pression change. Il se déclenche d'abord après l'événement `mousedown` et s'arrête avant l'événement `mouseup`.

Propriété des évènements
------------------------

La propriété suivante est connue pour être disponible sur les objets évènement `webkitmouseforcewillbegin` (en-US), `mousedown`, `webkitmouseforcechanged` (en-US), `webkitmouseforcedown` (en-US), `webkitmouseforceup` (en-US), `mousemove` et `mouseup`:

`MouseEvent.webkitForce` (en-US) 
Non-standard
 Lecture seule 

La quantité de pression actuellement appliquée sur le trackpad / écran tactile.

Constantes
----------

Ces constantes sont utiles pour déterminer l'intensité relative de la pression indiquée par `MouseEvent.webkitForce` (en-US) :

`MouseEvent.WEBKIT_FORCE_AT_MOUSE_DOWN` (en-US) 
Non-standard
Lecture seule 

Force minimum nécessaire pour un click normal.

`MouseEvent.WEBKIT_FORCE_AT_FORCE_MOUSE_DOWN` (en-US) 
Non-standard
Lecture seule 

Force minimum nécessaire pour un click de force.

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

*Ne fait partie d'aucune spécification.* Apple a une description dans la bibilitothèque Mac Developer.
CredentialsContainer
====================

**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.

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

L'interface **`CredentialsContainer`**, rattachée à l'API Credential Management, expose des méthodes pour demander l'accès aux informations d'authentification et informer l'agent utilisateur lorsque des évènements pertinents se produisent (connexion et déconnexion réussies par exemple). On peut accéder à cette interface via `Navigator.credentials`.

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

Aucune.

### Gestionnaires d'évènements

Aucun.

Methods
-------

`CredentialsContainer.create()`Contexte sécurisé

Cette méthode renvoie une promesse (`Promise`) qui est résolue avec une nouvelle instance `Credential` construite selon les options fournies ou `null` si aucun objet `Credential` ne peut être créé.

`CredentialsContainer.get()`Contexte sécurisé

Cette méthode renvoie une promesse (`Promise`) qui est résolue avec l'instance de `Credential` qui correspond aux paramètres fournis.

`CredentialsContainer.preventSilentAccess()`Contexte sécurisé

Cette méthode active un marqueur qui indique si une connexion automatique est autorisée pour les futures visites sur cette origine et renvoie une promesse (`Promise`) vide.

On pourra par exemple appeler cette méthode après qu'un utilisateur se soit déconnecté d'un site web pour s'assurer qu'il n'est pas reconnecté à la prochaine visite. Dans des versions antérieures de la spécification, cette méthode était intitulée `requireUserMediation()`. Voir le tableau de compatibilité ci-après pour plus de détails.

`CredentialsContainer.store()`Contexte sécurisé

Cette méthode enregistre des informations d'authentification pour un utilisateur à partir d'une instance `Credential` fournie et renvoie cette instance dans une promesse (`Promise`).

Exemples
--------


```js
// TBD
```

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

| Specification |
| --- |
| Credential Management Level 1 # credentialscontainer |

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

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

Un objet qui implémente l'interface `StyleSheet` représente une seule feuille de style. Les feuilles de style CSS implémenteront également l'interface plus spécialisée `CSSStyleSheet` (en-US).

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

`StyleSheet.disabled`

Un booléen (`Boolean` (en-US)) indiquant si la feuille de style est appliquée ou non.

`StyleSheet.href` Lecture seule 

Une chaîne de caractères (`DOMString`) représentant l'emplacement de la feuille de style.

`StyleSheet.media` Lecture seule 

Une `MediaList` (en-US) représentant le média de destination pour les informations de style.

`StyleSheet.ownerNode` Lecture seule 

Un objet `Node` qui représente le nœud associant cette feuille de style avec le document courant.

`StyleSheet.parentStyleSheet` Lecture seule 

Un objet `StyleSheet` qui inclut l'objet courant si ce dernier possède un parent ou `null` s'il n'y en a pas.

`StyleSheet.title` Lecture seule 

Une chaîne de caractères (`DOMString`) indiquant le titre indicatif de la feuille de style courante.

`StyleSheet.type` Lecture seule 

Une chaîne de caractères `DOMString` indiquant le langage de représentation pour cette feuille de style.

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

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

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

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

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

* `CSSStyleSheet` (en-US)
HTMLDocument
============

**`HTMLDocument`** est une interface abstraite de DOM qui fournit un accès aux propriétés spéciales et aux méthodes non présentes par défaut dans un document ordinaire (XML).

Ses méthodes et propriétés sont incluses dans la page `document` et listées séparément dans leur propre section DOM référencées ci-dessus.

Spécification
-------------

* http://www.w3.org/TR/DOM-Level-2-HTM...ml#ID-26809268
SVGAElement
===========

SVG a DOM interface
-------------------

L'interface `SVGAElement` fournit un accès aux propriétés des éléments `<a>` ainsi qu'aux méthodes pour les manipuler.

### Interface overview

|  |  |
| --- | --- |
| Egalement implémenté | `SVGElement`,
 `SVGURIReference` (en-US),
 `SVGTests`,
 `SVGLangSpace`,
 `SVGExternalResourcesRequired`,
 `SVGStylable`,
 `SVGTransformable` |
| Methodes | *Aucune* |
| Propriétés | * lectureseule`SVGAnimatedString` (en-US)
`cible`
 |
| Document Normative | SVG 1.1 (2nd Edition) |

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

| Nom | Type | Description |
| --- | --- | --- |
| `cible` | `SVGAnimatedString` (en-US) | Correspond à attribuer `cible` sur l'élément `<a>` donné. |

Methodes
--------

L'interface `SVGAElement` ne fournit aucune méthode spécifique.

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

| Specification |
| --- |
| Scalable Vector Graphics (SVG) 2 # InterfaceSVGAElement |

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

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

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

* `<a>` SVG Element
HTMLBRElement
=============

L'interface **`HTMLBRElement`** représente un retour à la ligne. Il hérite de `HTMLElement`.

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

*Hérite les propriétés de son parent : `HTMLElement`.*

| Nom | Type | Description |
| --- | --- | --- |
| `clear` 
Obsolète
 | `DOMString` | Indique le flux du texte autours des objets flottants. |

Méthodes
--------

*Aucune méthode spécifique ;* *hérite les méthodes de son parent, `HTMLElement`*.

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

| Specification |
| --- |
| HTML Standard # htmlbrelement |

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

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

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

* L'élément HTML supportant cet interface : `<br>`
DeviceOrientationEvent
======================

**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.

Sommaire
--------

L'évènement `DeviceOrientationEvent` met à la disposition du développeur des informations sur l'orientation de l'appareil visitant une page Web

**Attention :** à l'heure actuelle, Firefox et Chrome ne gèrent pas les cordonnées de la même façon. Tenez-en compte lors de l'utilisation de cette API.

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

`DeviceOrientationEvent.absolute` Lecture seule 

Un booléen, indiquant si l'appareil partage les informations sur son orientation absolue.

`DeviceOrientationEvent.alpha` (en-US) Lecture seule 

Un nombre, représentant le mouvement de l'appareil sur l'axe « z » exprimé en degrés sur une échelle de 0° à 360°.

`DeviceOrientationEvent.beta` (en-US) Lecture seule 

Un Nombre représentant le déplacement de l'appareil sur l'axe « x », exprimé en degrés sur une échelle de -180° à 180°.

`DeviceOrientationEvent.gamma` (en-US) Lecture seule 

Un nombre représentant le déplacement de l'appareil sur l'axe « y », exprimé en degrés sur une échelle de -90° à 90°.

Exemple
-------


```js
window.addEventListener("deviceorientation", function (event) {
  console.log(
    "z : " + event.alpha + "\n x : " + event.beta + "\n y : " + event.gamma,
  );
});
```

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

| Specification |
| --- |
| DeviceOrientation Event Specification # deviceorientation |

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

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

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

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

**Contexte sécurisé:** Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

L'interface **`AuthenticatorAttestationResponse`**, rattachée à l'API Web Authentication, est renvoyée par un appel à `CredentialsContainer.create()` lorsqu'un objet `PublicKeyCredential` est passé à la méthode. Elle fournit une racine cryptographique de confiance pour la nouvelle paire de clés qui a été générée.

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

`AuthenticatorAttestationResponse.clientDataJSON`

Les données relatives aux client pour l'authentification telles que l'origine et le *challenge*. La propriété `clientDataJSON` est héritée de l'interface `AuthenticatorResponse`.

`AuthenticatorAttestationResponse.attestationObject` (en-US)

Un objet `ArrayBuffer` qui contient les données de l'authenticateur ainsi qu'une instruction d'attestation pour la nouvelle paire de clés.

Méthodes
--------

Aucune.

Exemples
--------

TBD

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

| Specification |
| --- |
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # authenticatorattestationresponse |

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

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

Le `CompositionEvent DOM` représente les évènements qui se produisent en raison de l'utilisateur entrant indirectement le texte.

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

`CompositionEvent()` (en-US)

Crée une nouvelle instance d'objet `CompositionEvent` .

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

*Cette interface hérite également des propriétés de son parent, `UIEvent` et son ancêtre — `Event`.*

`CompositionEvent.data` (en-US) Lecture seule 

Renvoie les caractères générés par la méthode d'entrée qui a relevé l'événement ; cela varie en fonction du type d'événement ayant généré l'objet `CompositionEvent`.

`CompositionEvent.locale` (en-US) Lecture seule  
Obsolète

Renvoie les paramètres régionaux de la méthode de saisie actuelle (par exemple, les paramètres régionaux de disposition du clavier si la composition est associée à IME).

Méthodes
--------

*Cette interface hérite également des méthodes de son parent, `UIEvent` et son ancêtre — `Event`.*

`CompositionEvent.initCompositionEvent()` (en-US) 
Obsolète

Initialise les attributs d'un objet `CompositionEvent.`

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

| Specification |
| --- |
| UI Events # interface-compositionevent |

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

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

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

* `compositionstart`
* `compositionend`
* `compositionupdate`
* UIEvent
* Event
Client
======

L'interface `Client` de l'API ServiceWorker (en-US) représente la portée d'exécution d'un `Worker` ou `SharedWorker`. Les clients `Window` sont représentés par le plus spécifique `WindowClient`. Vous pouvez obtenir les objets `Client`/`WindowClient` via les méthodes `Clients.matchAll()` et `Clients.get()`.

Méthodes
--------

`Client.postMessage()`

Permet à un service worker d'envoyer un message au `ServiceWorkerClient` (en-US).

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

`Client.id` Lecture seule 

Retourne l'identifiant universellement unique de l'objet `Client`.

`Client.type` (en-US) Lecture seule 

Indique le type de contexte de navigation du client courant. Cette valeur peut être `auxiliary`, `top-level`, `nested`, or `none`.

`Client.url` Lecture seule 

Retourne l'URL du client service worker courant.

Exemples
--------

Ce code est basé sur un fragment pris d'un exemple d'envoi de message (voir l'exemple en ligne.) Ce code envoie une référence de message à laquelle le service worker peut répondre via `Client.postMessage()`.

Ce message est contenu dans une promesse qui est résolue si la réponse ne contient pas d'erreur et est rejetée avec une erreur.


```js
// client service worker (par exemple un document)
function sendMessage(message) {
  return new Promise(function (resolve, reject) {
    // Notez que c'est la version du ServiceWorker.postMessage
    navigator.serviceWorker.controller.postMessage(message);
    window.serviceWorker.onMessage = function (e) {
      resolve(e.data);
    };
  });
}

// Contrôle du service worker
self.addEventListener("message", function (e) {
  // e.source est un object client
  e.source.postMessage("Hello! Your message was: " + e.data);
});
```

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

| Specification |
| --- |
| Service Workers # client-interface |

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

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

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

* Utiliser les Service Workers (en-US)
* Exemple simple de service workers
* Est ce que le ServiceWorker est prêt ?
* Promesses
* Utilisation performante des web workers (en-US)
* Channel Messaging API (en-US)
UIEvent
=======

L'interface **`UIEvent`** représente des évènements simples de l'interface utilisateur.

`UIEvent` dérive de `Event`. Bien que la méthode `UIEvent.initUIEvent()` (en-US) soit conservée pour la compatibilité ascendante, vous devez créer un objet `UIEvent` en utilisant le constructeur `UIEvent()` (en-US).

Plusieurs interfaces descendent directement ou indirectement de celle-ci : `MouseEvent`, `FocusEvent`, `KeyboardEvent`, `WheelEvent`, `InputEvent` et `CompositionEvent`.

Constructeurs
-------------

`UIEvent()` (en-US)

Crée un objet `UIEvent`.

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

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

`UIEvent.cancelBubble` (en-US) 
Non-standard

Obsolète

`Boolean` *(booléen)* indiquant si les conséquences de l'évènement ont été annulées ou non.


`UIEvent.detail`Lecture seule 

Retourne un `long` qui donne quelques détails sur l'évènement, dépendant du type d'évènement.

`UIEvent.isChar` 
Obsolète
 Lecture seule 

Retourne un `Boolean` indiquant si l'évènement a produit un caractère clé ou non.

`UIEvent.layerX` 
Non-standard
 Lecture seule 

Retourne la coordonnée horizontale de l'évènement par rapport à la couche actuelle.

`UIEvent.layerY` (en-US) 
Non-standard
 Lecture seule 

Retourne la coordonnée verticale de l'évènement par rapport à la couche actuelle.

`UIEvent.pageX` (en-US) 
Non-standard
 Lecture seule 

Retourne la coordonnée horizontale de l'évènement par rapport à l'ensemble du document.

`UIEvent.pageY` (en-US) 
Non-standard
 Lecture seule 

Retourne la coordonnée verticale de l'évènement par rapport à l'ensemble du document.

`UIEvent.sourceCapabilities` (en-US) 
Non-standard
 Lecture seule 

Retourne une instance de l'interface `InputDeviceCapabilities` qui fournit des informations sur le périphérique physique responsable de l'évènement.

`UIEvent.view` (en-US)Lecture seule 

Retourne un `WindowProxy` qui contient la vue de la génération de l'évènement.

`UIEvent.which` (en-US) 
Non-standard
 Lecture seule 

Retourne l'identifiant `keyCode` de la touche pressée, ou le code du caractère (`charCode`) pour une touche alphanumérique enfoncée.

Méthodes
--------

*Cette interface hérite également des méthodes de son parent, `Event`.*

`UIEvent.initUIEvent()` (en-US) 
Obsolète

Initialise un objet `UIEvent`. Si l'évènement a déjà été envoyé, cette méthode ne fait rien.

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

| Specification |
| --- |
| UI Events # idl-uievent |

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

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

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

* Introduction to events
* `Event`
IntersectionObserverEntry
=========================

**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.

L'interface **`IntersectionObserverEntry`** de l'API Intersection Observer décrit l'intersection entre l'élément cible et son conteneur (appelé racine) à un moment spécifique de transition.

Les instances de `IntersectionObserverEntry` sont délivrées à une fonction de rappel de l'`IntersectionObserver` en tant que paramètres `entries` ; autrement, ces objets ne peuvent être obtenus qu'en appelant `IntersectionObserver.takeRecords()`.

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

`IntersectionObserverEntry.boundingClientRect` (en-US) Lecture seule 

Retourne les limites de la zone couverte par l'élément cible comme `DOMRectReadOnly`. Ces limites sont calculées comme décrit dans la documentation pour `Element.getBoundingClientRect()`.

`IntersectionObserverEntry.intersectionRatio` (en-US) Lecture seule 

Retourne le ratio de l'`intersectionRect` au `boundingClientRect`.

`IntersectionObserverEntry.intersectionRect` (en-US) Lecture seule 

Retourne un `DOMRectReadOnly` représentant la partie visible de l'élément cible.

`IntersectionObserverEntry.isIntersecting` (en-US) Lecture seule 

Retourne une valeur booléenne valant `true` si l'élément cible s'entrecoupe avec la zone d'intersection de l'élément racine. S'il vaut `true`, alors `IntersectionObserverEntry` décrit une transition vers un état d'intersection ; S'il vaut `false`, alors la transition se fait d'un état d'intersection à un état de non-intersection.

`IntersectionObserverEntry.rootBounds` (en-US) Lecture seule 

Retourne un `DOMRectReadOnly` pour la zone d'intersection de l'élément racine.

`IntersectionObserverEntry.target` Lecture seule 

L'`Element` dont l'intersection avec la racine a changé d'état.

`IntersectionObserverEntry.time` (en-US) Lecture seule 

Un `DOMHighResTimeStamp` indiquant l'instant auquel l'intersection a été enregistrée, relative au temps originel de l'`IntersectionObserver`.

Méthodes
--------

*Cette interface n'a pas de méthode.*

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

| Specification |
| --- |
| Intersection Observer # intersection-observer-entry |

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

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