diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/navigator | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/navigator')
16 files changed, 577 insertions, 764 deletions
diff --git a/files/fr/web/api/navigator/battery/index.md b/files/fr/web/api/navigator/battery/index.md index 59595e4a78..7b28c3c973 100644 --- a/files/fr/web/api/navigator/battery/index.md +++ b/files/fr/web/api/navigator/battery/index.md @@ -3,44 +3,41 @@ title: window.navigator.battery slug: Web/API/Navigator/battery translation_of: Web/API/Navigator/battery --- -<p>{{ Apiref() }}</p> +{{ Apiref() }} -<p>{{ SeeCompatTable() }}</p> +{{ SeeCompatTable() }} -<p>L'API Battery Status fournit des informations sur le niveau de charge du système et vous permet d'être notifiée via certains évènements si le niveau de batterie varie. Elle peut être utilisée pour privilégier les tâches moins gourmantes en traitement processeur sur votre site si le niveau de batterie est faible ou permettre une sauvegarde de vos travaux pour prévir d'une perte de données si la batterie est presque vide.</p> +L'API Battery Status fournit des informations sur le niveau de charge du système et vous permet d'être notifiée via certains évènements si le niveau de batterie varie. Elle peut être utilisée pour privilégier les tâches moins gourmantes en traitement processeur sur votre site si le niveau de batterie est faible ou permettre une sauvegarde de vos travaux pour prévir d'une perte de données si la batterie est presque vide. -<h2 id="Attributs">Attributs</h2> +## Attributs -<dl> - <dt><code>charging</code></dt> - <dd><strong>Lecture seule</strong>. Un booléen représentant le statut de charge de la batterie du système. Il retourne <code>vrai</code> si la batterie est en charge, si l'état de charge n'est pas déterminable, ou si aucune batterie n'est branchée au système. Retourne <code>faux</code> si la batterie est en cours de décharge.</dd> - <dt><code>chargingTime</code></dt> - <dd><strong>Lecture seule</strong>. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement chargée. Retourne 0 si la batterie est complètement chargée.<br> - Retourne un infini positif si la batterie se décharge ou si l'implémentation est incapable de déterminer le temps de charge restant.</dd> - <dt><code>dischargingTime</code></dt> - <dd><strong>Lecture seule</strong>. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement déchargée et que le système ne soit suspendu. Retourne un infini positif si la batterie est en charge, si l'implémentation n'est pas capable de déterminer le temps de décharge restant, ou s'il n'y a pas de batterie branchée au système.</dd> - <dt><code>level</code></dt> - <dd><strong>Lecture seule</strong>. Un double représentant le niveau de charge de la batterie du système, échelonné de 0 à 1.0. Retourne 0 si la batterie est vide et que le système est sur le point d'être suspendu. Retourne 1.0 si la batterie est pleine, si l'implémentation n'est pas capable de déterminer le niveau de charge de la batterie, ou s'il n'y a pas de batterie branchée au système.</dd> -</dl> +- `charging` + - : **Lecture seule**. Un booléen représentant le statut de charge de la batterie du système. Il retourne `vrai` si la batterie est en charge, si l'état de charge n'est pas déterminable, ou si aucune batterie n'est branchée au système. Retourne `faux` si la batterie est en cours de décharge. +- `chargingTime` + - : **Lecture seule**. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement chargée. Retourne 0 si la batterie est complètement chargée. + Retourne un infini positif si la batterie se décharge ou si l'implémentation est incapable de déterminer le temps de charge restant. +- `dischargingTime` + - : **Lecture seule**. Un double représentant le temps restant en secondes avant que la batterie ne soit complètement déchargée et que le système ne soit suspendu. Retourne un infini positif si la batterie est en charge, si l'implémentation n'est pas capable de déterminer le temps de décharge restant, ou s'il n'y a pas de batterie branchée au système. +- `level` + - : **Lecture seule**. Un double représentant le niveau de charge de la batterie du système, échelonné de 0 à 1.0. Retourne 0 si la batterie est vide et que le système est sur le point d'être suspendu. Retourne 1.0 si la batterie est pleine, si l'implémentation n'est pas capable de déterminer le niveau de charge de la batterie, ou s'il n'y a pas de batterie branchée au système. -<h2 id="Evènements">Evènements</h2> +## Evènements -<dl> - <dt><code>chargingchange</code></dt> - <dd>Déclenché lorsque l'état de charge de la batterie est mis à jour.</dd> - <dt><code>chargingtimechange</code></dt> - <dd>Déclenché lorsque le temps de charge de la batterie est mis à jour.</dd> - <dt><code>dischargingtimechange</code></dt> - <dd>Déclenché lorsque le temps de decharge de la batterie est mis à jour.</dd> - <dt><code>levelchange</code></dt> - <dd>Déclenché lorsque le niveau de charge de la batterie est mis à jour.</dd> -</dl> +- `chargingchange` + - : Déclenché lorsque l'état de charge de la batterie est mis à jour. +- `chargingtimechange` + - : Déclenché lorsque le temps de charge de la batterie est mis à jour. +- `dischargingtimechange` + - : Déclenché lorsque le temps de decharge de la batterie est mis à jour. +- `levelchange` + - : Déclenché lorsque le niveau de charge de la batterie est mis à jour. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Voir aussi <a href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">l'exemple dans la specification</a>.</p> +Voir aussi [l'exemple dans la specification](http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction). -<pre class="brush: js">var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery; +```js +var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery; function updateBatteryStatus() { alert("Battery status: " + battery.level * 100 + " %"); @@ -53,15 +50,13 @@ function updateBatteryStatus() { battery.addEventListener("chargingchange", updateBatteryStatus); battery.addEventListener("levelchange", updateBatteryStatus); updateBatteryStatus(); -</pre> +``` -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Navigator.battery")}}</p> +{{Compat("api.Navigator.battery")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Blog post - Using the Battery API</a></li> - <li><a href="http://davidwalsh.name/battery-api">David Walsh on the Javascript Battery Api</a></li> -</ul>
\ No newline at end of file +- [Blog post - Using the Battery API](http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/) +- [David Walsh on the Javascript Battery Api](http://davidwalsh.name/battery-api) diff --git a/files/fr/web/api/navigator/connection/index.md b/files/fr/web/api/navigator/connection/index.md index 5d46c33194..e2e9f34956 100644 --- a/files/fr/web/api/navigator/connection/index.md +++ b/files/fr/web/api/navigator/connection/index.md @@ -9,39 +9,24 @@ tags: - Propriété translation_of: Web/API/Navigator/connection --- -<p>{{APIRef("Network Information API")}}{{SeeCompatTable}}</p> +{{APIRef("Network Information API")}}{{SeeCompatTable}} -<p><code><strong>Navigator.connection</strong></code> est une propriété en lecture seule, elle représente une {{domxref("NetworkInformation")}} qui contient les informations de la connexion du système, telles que la bande passante actuelle du périphérique utilisateur ou si la connexion est mesurée. La propriété peut être utilisée pour sélectionner un contenu en haute ou basse définition, dépendant de la connexion de l'utilisateur.</p> +**`Navigator.connection`** est une propriété en lecture seule, elle représente une {{domxref("NetworkInformation")}} qui contient les informations de la connexion du système, telles que la bande passante actuelle du périphérique utilisateur ou si la connexion est mesurée. La propriété peut être utilisée pour sélectionner un contenu en haute ou basse définition, dépendant de la connexion de l'utilisateur. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>connexionInfo</em> = navigator.connection</pre> + connexionInfo = navigator.connection -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Network Information', '#h-the-connection-attribute', 'Navigator.connection')}}</td> - <td>{{Spec2('Network Information')}}</td> - <td>Spécification initiale</td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ---------------------- | +| {{SpecName('Network Information', '#h-the-connection-attribute', 'Navigator.connection')}} | {{Spec2('Network Information')}} | Spécification initiale | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Navigator.connection")}}</p> +{{Compat("api.Navigator.connection")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/NavigatorOnLine/Online_and_offline_events">Évènements online et offline</a></li> -</ul> +- [Évènements online et offline](/fr/docs/Web/API/NavigatorOnLine/Online_and_offline_events) diff --git a/files/fr/web/api/navigator/cookieenabled/index.md b/files/fr/web/api/navigator/cookieenabled/index.md index 91d3ae78e0..babc7e40fb 100644 --- a/files/fr/web/api/navigator/cookieenabled/index.md +++ b/files/fr/web/api/navigator/cookieenabled/index.md @@ -3,47 +3,32 @@ title: Navigator.cookieEnabled slug: Web/API/Navigator/cookieEnabled translation_of: Web/API/Navigator/cookieEnabled --- -<p>{{ ApiRef("HTML DOM") }}</p> +{{ ApiRef("HTML DOM") }} -<p><code>navigator.cookieEnabled</code> retourne une valeur booléenne qui indique si les cookies sont activés. Cette propriété est en lecture seule.</p> +`navigator.cookieEnabled` retourne une valeur booléenne qui indique si les cookies sont activés. Cette propriété est en lecture seule. -<h2 id="Syntax">Syntax</h2> +## Syntax -<pre class="brush: js">var cookieEnabled = navigator.cookieEnabled; -</pre> +```js +var cookieEnabled = navigator.cookieEnabled; +``` -<ul> - <li><code>cookieEnabled</code> est un <a href="/en-US/docs/Glossary/Boolean">Boolean</a>: <code>true</code> ou <code>false</code>.</li> -</ul> +- `cookieEnabled` est un [Boolean](/en-US/docs/Glossary/Boolean): `true` ou `false`. -<h2 id="Example">Example</h2> +## Example -<pre class="brush: js">if (!navigator.cookieEnabled) { +```js +if (!navigator.cookieEnabled) { // Ce navigateur ne supporte pas ou bloque les cookies. } -</pre> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("HTML WHATWG", "webappapis.html#dom-navigator-cookieenabled", "Navigator.cookieEnabled")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("HTML WHATWG", "webappapis.html#dom-navigator-cookieenabled", "Navigator.cookieEnabled")}} | {{Spec2("HTML WHATWG")}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs - - -<p>{{Compat("api.Navigator.cookieEnabled")}}</p> +{{Compat("api.Navigator.cookieEnabled")}} diff --git a/files/fr/web/api/navigator/credentials/index.md b/files/fr/web/api/navigator/credentials/index.md index 0629fcfe44..fb3d7063cc 100644 --- a/files/fr/web/api/navigator/credentials/index.md +++ b/files/fr/web/api/navigator/credentials/index.md @@ -9,21 +9,22 @@ tags: - Reference translation_of: Web/API/Navigator/credentials --- -<p>{{securecontext_header}}{{APIRef("")}}</p> +{{securecontext_header}}{{APIRef("")}} -<p>La propriété <strong><code>credentials</code></strong>, rattachée à l'interface {{domxref("Navigator")}}, renvoie l'interface {{domxref("CredentialsContainer")}} qui expose des méthodes pour demander des informations d'authentification. L'interface {{domxref("CredentialsContainer")}} notifie également l'agent utilisateur lorsqu'un évènement pertinent se produit (une connexion ou une déconnexion réussie par exemple). Cette propriété peut être utilisée pour détecter si la fonctionnalité est prise en charge ou non.</p> +La propriété **`credentials`**, rattachée à l'interface {{domxref("Navigator")}}, renvoie l'interface {{domxref("CredentialsContainer")}} qui expose des méthodes pour demander des informations d'authentification. L'interface {{domxref("CredentialsContainer")}} notifie également l'agent utilisateur lorsqu'un évènement pertinent se produit (une connexion ou une déconnexion réussie par exemple). Cette propriété peut être utilisée pour détecter si la fonctionnalité est prise en charge ou non. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var credentialsContainer = navigator.credentials</pre> + var credentialsContainer = navigator.credentials -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>L'interface {{domxref("CredentialsContainer")}}.</p> +L'interface {{domxref("CredentialsContainer")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">if ('credentials' in navigator) { +```js +if ('credentials' in navigator) { navigator.credentials.get({password: true}) .then(function(creds) { // Gérer les informations d'authentification @@ -31,27 +32,14 @@ translation_of: Web/API/Navigator/credentials } else { // Gérer la connexion comme avant }; -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Credential Management')}}</td> - <td>{{Spec2('Credential Management')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Navigator.credentials")}}</p> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------ | -------------------------------------------- | -------------------- | +| {{SpecName('Credential Management')}} | {{Spec2('Credential Management')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Navigator.credentials")}} diff --git a/files/fr/web/api/navigator/donottrack/index.md b/files/fr/web/api/navigator/donottrack/index.md index 9acf7c3241..ae9cce2869 100644 --- a/files/fr/web/api/navigator/donottrack/index.md +++ b/files/fr/web/api/navigator/donottrack/index.md @@ -8,48 +8,31 @@ tags: - Reference translation_of: Web/API/Navigator/doNotTrack --- -<p>{{ApiRef("HTML DOM")}}{{SeeCompatTable}}</p> +{{ApiRef("HTML DOM")}}{{SeeCompatTable}} -<p>Renvoi le paramètre utilisateur de <strong>do-not-track</strong>. Cette valeur est "1" si l´utilisateur a demandé de ne pas être suivi par les sites web, le contenu ou la publicité.</p> +Renvoi le paramètre utilisateur de **do-not-track**. Cette valeur est "1" si l´utilisateur a demandé de ne pas être suivi par les sites web, le contenu ou la publicité. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="eval"><em>dnt</em> = <em>navigator</em>.doNotTrack; -</pre> + dnt = navigator.doNotTrack; -<p>La valeur reflète celle de l'en-tête "do-not-track" <em>(ne pas suivre)</em>, c'est-à-dire {"1", "0", "unspecified" }. Note : Avant Gecko 32, Gecko a utilisé les valeurs { "yes", "no", "unspecified"} (<a href="https://bugzilla.mozilla.org/show_bug.cgi?id=887703">bug 887703</a>).</p> +La valeur reflète celle de l'en-tête "do-not-track" _(ne pas suivre)_, c'est-à-dire {"1", "0", "unspecified" }. Note : Avant Gecko 32, Gecko a utilisé les valeurs { "yes", "no", "unspecified"} ([bug 887703](https://bugzilla.mozilla.org/show_bug.cgi?id=887703)). -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="eval">dump(window.navigator.doNotTrack); -// écrit "1" si DNT est activé; "0" si l'utilisateur a opté pour le suivi; sinon c'est "unspecified" <em>(non spécifié)</em> -</pre> + dump(window.navigator.doNotTrack); + // écrit "1" si DNT est activé; "0" si l'utilisateur a opté pour le suivi; sinon c'est "unspecified" (non spécifié) -<h2 id="Specification">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("Tracking", "#widl-Navigator-doNotTrack", "Navigator.doNotTrack")}}</td> - <td>{{Spec2("Tracking")}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------- | +| {{SpecName("Tracking", "#widl-Navigator-doNotTrack", "Navigator.doNotTrack")}} | {{Spec2("Tracking")}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.Navigator.doNotTrack")}}</p> +{{Compat("api.Navigator.doNotTrack")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/Security/Do_not_track_field_guide">Le guide pratique Do Not Track</a></li> -</ul> +- [Le guide pratique Do Not Track](/fr/docs/Web/Security/Do_not_track_field_guide) diff --git a/files/fr/web/api/navigator/geolocation/index.md b/files/fr/web/api/navigator/geolocation/index.md index 3d534b7c95..c247e35ace 100644 --- a/files/fr/web/api/navigator/geolocation/index.md +++ b/files/fr/web/api/navigator/geolocation/index.md @@ -9,44 +9,26 @@ tags: - Reference translation_of: Web/API/Navigator/geolocation --- -<div>{{APIRef("Geolocation API")}}</div> +{{APIRef("Geolocation API")}} -<p><strong><code>Navigator.geolocation</code></strong> est une propriété en lecture seule, qui retoune un objet {{domxref("Geolocation")}} donnant accès aux contenus web de localisation de l'appareil. Ceci permet à un site Internet ou à une application d'offrir des résultats personnalisés basés sur la localisation des utilisateurs.</p> +**`Navigator.geolocation`** est une propriété en lecture seule, qui retoune un objet {{domxref("Geolocation")}} donnant accès aux contenus web de localisation de l'appareil. Ceci permet à un site Internet ou à une application d'offrir des résultats personnalisés basés sur la localisation des utilisateurs. -<div class="note"> -<p><strong>Note:</strong> Pour des raisons de sécurité, quand une page web essaie d'accéder aux informations de localisation, l'utilisateur reçoit une notification qui lui demande la permission d'activer cette fonctionnalité. Chaque navigateur a sa propre politique et ses propres méthodes pour demander cette permission.</p> -</div> +> **Note :** Pour des raisons de sécurité, quand une page web essaie d'accéder aux informations de localisation, l'utilisateur reçoit une notification qui lui demande la permission d'activer cette fonctionnalité. Chaque navigateur a sa propre politique et ses propres méthodes pour demander cette permission. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>geo</var> = <var>navigator</var>.geolocation -</pre> + geo = navigator.geolocation -<h2 id="Specifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Geolocation', '#navi-geo', 'Navigator.geolocation')}}</td> - <td>{{Spec2('Geolocation')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | -------------------------------- | ------------------ | +| {{SpecName('Geolocation', '#navi-geo', 'Navigator.geolocation')}} | {{Spec2('Geolocation')}} | Initial definition | -<h2 id="Browser_compatibility">Compatibilité navigateur</h2> +## Compatibilité navigateur -<p>{{Compat("api.Navigator.geolocation")}}</p> +{{Compat("api.Navigator.geolocation")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/WebAPI/Using_geolocation">Utiliser la géolocalisation</a></li> -</ul> +- [Utiliser la géolocalisation](/fr/docs/WebAPI/Using_geolocation) diff --git a/files/fr/web/api/navigator/getgamepads/index.md b/files/fr/web/api/navigator/getgamepads/index.md index 0f7480f238..5ca49cb54c 100644 --- a/files/fr/web/api/navigator/getgamepads/index.md +++ b/files/fr/web/api/navigator/getgamepads/index.md @@ -3,51 +3,38 @@ title: Navigator.getGamepads() slug: Web/API/Navigator/getGamepads translation_of: Web/API/Navigator/getGamepads --- -<p>{{ APIRef("Navigator") }}{{SeeCompatTable}}</p> +{{ APIRef("Navigator") }}{{SeeCompatTable}} -<p>La méthode <strong><code>Navigator.getGamepads()</code></strong> renvoie un tableau d'objets {{ domxref("Gamepad") }}, un par contrôleur connecté à la machine.</p> +La méthode **`Navigator.getGamepads()`** renvoie un tableau d'objets {{ domxref("Gamepad") }}, un par contrôleur connecté à la machine. -<p>Des éléments dans le tableau peuvent être <code>null</code> si un contrôleur est déconnecté durant la session, ainsi les autres restants gardent le même indice.</p> +Des éléments dans le tableau peuvent être `null` si un contrôleur est déconnecté durant la session, ainsi les autres restants gardent le même indice. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"> var arrayGP = navigator.getGamepads();</pre> + var arrayGP = navigator.getGamepads(); -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">window.addEventListener("gamepadconnected", function(e) { +```js +window.addEventListener("gamepadconnected", function(e) { var gp = navigator.getGamepads()[0]; console.log("Contrôleur n°%d connecté : %s. %d boutons, %d axes.", gp.index, gp.id, gp.buttons.length, gp.axes.length); -});</pre> +}); +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('Gamepad', '', 'The Gamepad API specification')}}</td> - <td>{{Spec2('Gamepad')}}</td> - <td>Première définition.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('Gamepad', '', 'The Gamepad API specification')}} | {{Spec2('Gamepad')}} | Première définition. | -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.Navigator.getGamepads")}} +## Voir aussi -<p>{{Compat("api.Navigator.getGamepads")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/Guide/API/Gamepad">Utiliser l'API Gamepad</a></li> - <li><a href="/fr/docs/Web/API/Gamepad_API">L'API Gamepad</a></li> -</ul> +- [Utiliser l'API Gamepad](/fr/docs/Web/Guide/API/Gamepad) +- [L'API Gamepad](/fr/docs/Web/API/Gamepad_API) diff --git a/files/fr/web/api/navigator/getusermedia/index.md b/files/fr/web/api/navigator/getusermedia/index.md index 2c2d6edcac..32c5946175 100644 --- a/files/fr/web/api/navigator/getusermedia/index.md +++ b/files/fr/web/api/navigator/getusermedia/index.md @@ -10,55 +10,55 @@ tags: translation_of: Web/API/Navigator/getUserMedia original_slug: NavigatorUserMedia.getUserMedia --- -<div>{{APIRef("Media Capture and Streams")}}{{deprecated_header}}</div> +{{APIRef("Media Capture and Streams")}}{{deprecated_header}} -<p>La fonction obsolète <strong>Navigator.getUserMedia()</strong> demande à l'utilisateur la permission d'utiliser une entrée vidéo (ex: une webcam ou un écran partagé) ou audio (ex: un microphone) de l'utilisateur.</p> +La fonction obsolète **Navigator.getUserMedia()** demande à l'utilisateur la permission d'utiliser une entrée vidéo (ex: une webcam ou un écran partagé) ou audio (ex: un microphone) de l'utilisateur. -<p>Si ce dernier l'autorise, un {{domxref("MediaStream")}} est transmis au callback spécifié, il contient les pistes audio et/ou vidéo des entrées autorisées. Si l'utilisateur refuse l'accès, que le périphérique n'existe pas, ou qu'une erreur quelconque se produit, le callback d'erreur est alors exécuté avec comme paramètre un objet {{domxref("MediaStreamError")}}, il décrit l'erreur qui vient de se produire. Si l'utilisateur ne fait aucun choix, aucun callback n'est exécuté.</p> +Si ce dernier l'autorise, un {{domxref("MediaStream")}} est transmis au callback spécifié, il contient les pistes audio et/ou vidéo des entrées autorisées. Si l'utilisateur refuse l'accès, que le périphérique n'existe pas, ou qu'une erreur quelconque se produit, le callback d'erreur est alors exécuté avec comme paramètre un objet {{domxref("MediaStreamError")}}, il décrit l'erreur qui vient de se produire. Si l'utilisateur ne fait aucun choix, aucun callback n'est exécuté. -<div class="note"> -<p><strong>Note :</strong> Il s'agit d'une ancienne méthode, veuillez utiliser la méthode {{domxref("MediaDevices.getUserMedia", "navigator.mediaDevices.getUserMedia()")}} à la place. Bien qu'elle ne soit pas techniquement obsolète, l'utilisation de callbacks l'est, les spécifications encouragent fortamment l'utilisation de la nouvelle version avec {{jsxref("promise", "promesses")}}.</p> -</div> +> **Note :** Il s'agit d'une ancienne méthode, veuillez utiliser la méthode {{domxref("MediaDevices.getUserMedia", "navigator.mediaDevices.getUserMedia()")}} à la place. Bien qu'elle ne soit pas techniquement obsolète, l'utilisation de callbacks l'est, les spécifications encouragent fortamment l'utilisation de la nouvelle version avec {{jsxref("promise", "promesses")}}. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">navigator.getUserMedia(constraints, successCallback, errorCallback);</pre> + navigator.getUserMedia(constraints, successCallback, errorCallback); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt>constraints</dt> - <dd>Un objet {{domxref("MediaStreamConstraints")}} spécifiant les types de médias que vous souhaitez recevoir, ainsi que les contraintes pour chaque type de média. Pour plus de détails, voir la section <a href="/fr/docs/Web/API/MediaDevices/getUserMedia#Syntaxe">constraints</a> de la méthode {{domxref("MediaDevices.getUserMedia()")}}, ainsi que l'article <a href="/fr/docs/Web/API/Media_Streams_API/Constraints">Capacités, constraintes, et configurations</a>.</dd> - <dt>successCallback</dt> - <dd>Une fonction qui est invoquée lorsque la demande d'accès aux entrées média est acceptée. Cette fonction est appellée avec un paramètre: l'objet {{domxref("MediaStream")}} qui contient les flux de médias. Votre callback peut assigner le stream l'objet que vous désirez (ex: un élément {{HTMLElement("audio")}} ou {{HTMLElement("video")}}), comme dans l'exemple suivant: - <pre class="brush: js">function(stream) { - var video = document.querySelector('video'); - video.src = window.URL.createObjectURL(stream); - video.onloadedmetadata = function(e) { - // Do something with the video here. - }; -} -</pre> - </dd> - <dt>errorCallback</dt> - <dd>Lorsque l'appel échoue, la fonction spécifiée dans <code>errorCallback</code> est appelée avec comme seul argument l'objet {{domxref("MediaStreamError")}}. Cet objet ressemble à {{domxref("DOMException")}}. Voir {anch("Erreurs")}} plus bas sur cette page pour voir quelle erreur peut arriver.</dd> -</dl> +- constraints + - : Un objet {{domxref("MediaStreamConstraints")}} spécifiant les types de médias que vous souhaitez recevoir, ainsi que les contraintes pour chaque type de média. Pour plus de détails, voir la section [constraints](/fr/docs/Web/API/MediaDevices/getUserMedia#Syntaxe) de la méthode {{domxref("MediaDevices.getUserMedia()")}}, ainsi que l'article [Capacités, constraintes, et configurations](/fr/docs/Web/API/Media_Streams_API/Constraints). +- successCallback + + - : Une fonction qui est invoquée lorsque la demande d'accès aux entrées média est acceptée. Cette fonction est appellée avec un paramètre: l'objet {{domxref("MediaStream")}} qui contient les flux de médias. Votre callback peut assigner le stream l'objet que vous désirez (ex: un élément {{HTMLElement("audio")}} ou {{HTMLElement("video")}}), comme dans l'exemple suivant: + + ```js + function(stream) { + var video = document.querySelector('video'); + video.src = window.URL.createObjectURL(stream); + video.onloadedmetadata = function(e) { + // Do something with the video here. + }; + } + ``` + +- errorCallback + - : Lorsque l'appel échoue, la fonction spécifiée dans `errorCallback` est appelée avec comme seul argument l'objet {{domxref("MediaStreamError")}}. Cet objet ressemble à {{domxref("DOMException")}}. Voir {anch("Erreurs")}} plus bas sur cette page pour voir quelle erreur peut arriver. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>{{domxref("undefined")}}.</p> +{{domxref("undefined")}}. -<h3 id="Erreurs">Erreurs</h3> +### Erreurs -<p>{{page("/fr/docs/Web/API/MediaDevices/getUserMedia", "Errors")}}</p> +{{page("/fr/docs/Web/API/MediaDevices/getUserMedia", "Errors")}} -<h2 id="Exemples"><strong>Exemples</strong></h2> +## **Exemples** -<h3 id="Largeur_et_hauteur">Largeur et hauteur</h3> +### Largeur et hauteur -<p>Voici un exemple de l'utilisation de <code>getUserMedia()</code>, avec les différentes mises en oeuvres pour couvrir les préfixes navigateurs. Remarquez que ceci est la façon dépréciée de procéder. Regardez les <a href="/en-US/docs/Web/API/MediaDevices/getUserMedia#Frame_rate">exemples</a> sous la section {{domxref("MediaDevices.getUserMedia()")}} pour les exemples modernes.</p> +Voici un exemple de l'utilisation de `getUserMedia()`, avec les différentes mises en oeuvres pour couvrir les préfixes navigateurs. Remarquez que ceci est la façon dépréciée de procéder. Regardez les [exemples](/en-US/docs/Web/API/MediaDevices/getUserMedia#Frame_rate) sous la section {{domxref("MediaDevices.getUserMedia()")}} pour les exemples modernes. -<pre class="brush: js">navigator.getUserMedia = navigator.getUserMedia || +```js +navigator.getUserMedia = navigator.getUserMedia || navigator.webkitGetUserMedia || navigator.mozGetUserMedia; @@ -77,13 +77,15 @@ if (navigator.getUserMedia) { ); } else { console.log("getUserMedia not supported"); -}</pre> +} +``` -<h2 id="Permissions">Permissions</h2> +## Permissions -<p>Pour utiliser <code>getUserMedia()</code> dans une application installable (par exemple une application Firefox OS), vous devez spécifier un ou plusieurs des champs suivants dans le fichier de manifest.</p> +Pour utiliser `getUserMedia()` dans une application installable (par exemple une application Firefox OS), vous devez spécifier un ou plusieurs des champs suivants dans le fichier de manifest. -<pre class="brush: js">"permissions": { +```js +"permissions": { "audio-capture": { "description": "Required to capture audio using getUserMedia()" }, @@ -91,42 +93,25 @@ if (navigator.getUserMedia) { "description": "Required to capture video using getUserMedia()" } } -</pre> - -<p>See <a href="/en-US/Apps/Developing/App_permissions#audio-capture">permission: audio-capture</a> and <a href="/en-US/Apps/Developing/App_permissions#video-capture">permission: video-capture</a> for more information.</p> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécifications</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Media Capture', '#navigatorusermedia-interface-extensions', 'navigator.getUserMedia')}}</td> - <td>{{Spec2('Media Capture')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div class="warning"> - <p><strong>Attention :</strong> Le nouveau code doit utiliser {{domxref("Navigator.mediaDevices.getUserMedia()")}} à la place.</p> -</div> - -<p>{{Compat("api.Navigator.getUserMedia")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("MediaDevices.getUserMedia()")}} qui remplace cette méthode dépréciée.</li> - <li><a href="/en-US/docs/WebRTC">WebRTC</a> - page d'introduction aux APIS</li> - <li><a href="/en-US/docs/WebRTC/MediaStream_API">MediaStream API</a> - L'API des Media Streams Objects</li> - <li><a href="/en-US/docs/WebRTC/taking_webcam_photos">Taking webcam photos</a> - un tutoriel à propos de l'utilisation de <code>getUserMedia()</code> pour prendre des photos plutôt que des vidéos.</li> -</ul> +``` + +See [permission: audio-capture](/en-US/Apps/Developing/App_permissions#audio-capture) and [permission: video-capture](/en-US/Apps/Developing/App_permissions#video-capture) for more information. + +## Spécifications + +| Spécifications | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | -------------------- | +| {{SpecName('Media Capture', '#navigatorusermedia-interface-extensions', 'navigator.getUserMedia')}} | {{Spec2('Media Capture')}} | Définition initiale. | + +## Compatibilité des navigateurs + +> **Attention :** Le nouveau code doit utiliser {{domxref("Navigator.mediaDevices.getUserMedia()")}} à la place. + +{{Compat("api.Navigator.getUserMedia")}} + +## Voir aussi + +- {{domxref("MediaDevices.getUserMedia()")}} qui remplace cette méthode dépréciée. +- [WebRTC](/en-US/docs/WebRTC) - page d'introduction aux APIS +- [MediaStream API](/en-US/docs/WebRTC/MediaStream_API) - L'API des Media Streams Objects +- [Taking webcam photos](/en-US/docs/WebRTC/taking_webcam_photos) - un tutoriel à propos de l'utilisation de `getUserMedia()` pour prendre des photos plutôt que des vidéos. diff --git a/files/fr/web/api/navigator/index.md b/files/fr/web/api/navigator/index.md index 6c258f9873..85798a44ed 100644 --- a/files/fr/web/api/navigator/index.md +++ b/files/fr/web/api/navigator/index.md @@ -11,168 +11,145 @@ tags: - Web Performance translation_of: Web/API/Navigator --- -<div>{{APIRef("DOM")}}</div> - -<p>L'interface <code><strong>Navigator</strong></code> représente l'état et l'identité de l'agent utilisateur courant. Elle permet aux scripts de consulter ces informations et de s'enregistrer en vue de certaines activités.</p> - -<p>Un objet instanciant <code>Navigator</code> peut être récupéré grâce à la propriété en lecture seule <a href="/fr/docs/Web/API/Window/navigator"><code>window.navigator</code></a>.</p> - -<h2 id="Properties">Propriétés</h2> - -<p><em>Cette interface n'hérite d'aucune propriété mais implémente celles définies par <a href="/fr/docs/Web/API/NavigatorID"><code>NavigatorID</code></a>, <a href="/fr/docs/Web/API/NavigatorLanguage"><code>NavigatorLanguage</code></a>, <a href="/fr/docs/Web/API/NavigatorOnLine"><code>NavigatorOnLine</code></a>, <a href="/fr/docs/Web/API/NavigatorContentUtils"><code>NavigatorContentUtils</code></a>, <a href="/fr/docs/Web/API/NavigatorStorage"><code>NavigatorStorage</code></a>, <a href="/fr/docs/Web/API/NavigatorStorageUtils"><code>NavigatorStorageUtils</code></a>, <a href="/fr/docs/Web/API/NavigatorConcurrentHardware"><code>NavigatorConcurrentHardware</code></a>, <a href="/fr/docs/Web/API/NavigatorPlugins"><code>NavigatorPlugins</code></a> et <a href="/fr/docs/Web/API/NavigatorUserMedia"><code>NavigatorUserMedia</code></a>.</em></p> - -<h3 id="Standard_properties">Propriétés standard</h3> - -<dl> - <dt><a href="/fr/docs/Web/API/Navigator/connection"><code>Navigator.connection</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Fournit un objet <a href="/fr/docs/Web/API/NetworkInformation"><code>NetworkInformation</code></a> contenant des informations quant à la connection réseau de l'appareil.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/cookieEnabled"><code>Navigator.cookieEnabled</code></a> {{readonlyinline}}</dt> - <dd>Renvoie un booléen indiquant si l'ajout d'un cookie sera pris en compte.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/credentials"><code>Navigator.credentials</code></a> {{readonlyInline}}</dt> - <dd>Renvoie l'interface <a href="/fr/docs/Web/API/CredentialsContainer"><code>CredentialsContainer</code></a> qui expose des méthodes pour la demande d'informations d'authentification et qui notifie l'agent utilisateur lors d'évènements particuliers tels que les connexions ou déconnexions.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/deviceMemory"><code>Navigator.deviceMemory</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Renvoie la quantité de mémoire de l'appareil, exprimée en gigaoctets. Cette valeur est une approximation calculée en prenant la plus proche puissance de 2 puis en divisant le résultat par 1024.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/doNotTrack"><code>Navigator.doNotTrack</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Indique le choix de l'utilisateur fournit pour la préférence <i>do-not-track</i>. Lorsque cette valeur vaut "1", l'application web ne devrait pas pister l'utilisateur.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/geolocation"><code>Navigator.geolocation</code></a> {{readonlyInline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/Geolocation"><code>Geolocation</code></a> permettant l'accès à l'emplacement géographique de l'appareil.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorConcurrentHardware.hardwareConcurrency"><code>NavigatorConcurrentHardware.hardwareConcurrency</code></a> {{readonlyInline}}</dt> - <dd>Renvoie le nombre de cœurs logiques du processeur.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorPlugins.javaEnabled"><code>NavigatorPlugins.javaEnabled</code></a> {{readonlyInline}}</dt> - <dd>Renvoie le booléen <code>false</code>.</dd> - <dt><a href="/fr/docs/Web/API/Navigator.keyboard"><code>Navigator.keyboard</code></a> {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/Keyboard"><code>Keyboard</code></a> qui permet d'accéder à des fonctions pour récupérer des informations sur la disposition du clavier et la capture de touches du clavier physique.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorLanguage.language"><code>NavigatorLanguage.language</code></a> {{readonlyInline}}</dt> - <dd>Renvoie une chaîne de caractères <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> indiquant la langue préférée de l'utilisateur (qui correspond généralement à la langue utilisée pour l'interface utilisateur du navigateur). La valeur <code>null</code> est renvoyée si cette information est inconnue.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorLanguage.languages"><code>NavigatorLanguage.languages</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Renvoie un tableau de chaînes <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> qui représente les langues connues de l'utilisateur, triées par ordre de préférence.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/locks"><code>Navigator.locks</code></a> {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/LockManager"><code>LockManager</code></a> qui fournit des méthodes pour demander un nouvel objet <a href="/fr/docs/Web/API/Lock"><code>Lock</code></a> ou s'enquérir d'un objet <a href="/fr/docs/Web/API/Lock"><code>Lock</code></a> existant.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/maxTouchPoints"><code>Navigator.maxTouchPoints</code></a> {{readonlyInline}}</dt> - <dd>Renvoie le nombre maximum de points de toucher simultanés possible pour l'appareil courant.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/mediaCapabilities"><code>Navigator.mediaCapabilities</code></a> {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/MediaCapabilities"><code>MediaCapabilities</code></a> qui peut exposer des informations sur le décodage/l'encodage d'un format donné.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/mediaDevices"><code>Navigator.mediaDevices</code></a> {{readonlyinline}}</dt> - <dd>Renvoie une référence vers un objet <a href="/fr/docs/Web/API/MediaDevices"><code>MediaDevices</code></a> permettant d'obtenir des informations à propos des appareils médias disponibles (<a href="/fr/docs/Web/API/MediaDevices.enumerateDevices()"><code>MediaDevices.enumerateDevices()</code></a>), de déterminer les propriétés et contraintes prises en charge pour les médias sur cet agent utilisateur et cet ordinateur (<a href="/fr/docs/Web/API/MediaDevices.getSupportedConstraints()"><code>MediaDevices.getSupportedConstraints()</code></a>), de demander l'accès au média via <a href="/fr/docs/Web/API/MediaDevices.getUserMedia()"><code>MediaDevices.getUserMedia()</code></a>.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/mediaSession"><code>Navigator.mediaSession</code></a> {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/MediaSession"><code>MediaSession</code></a> pouvant être utilisé afin de fournir des métadonnées utilisées par le navigateur afin de présenter des informations sur le média en cours de lecture (par exemple pour les interfaces utilisateurs générales de contrôle des médias).</dd> - <dt><a href="/fr/docs/Web/API/NavigatorPlugins.mimeTypes"><code>NavigatorPlugins.mimeTypes</code></a> {{readonlyInline}}{{deprecated_inline}}</dt> - <dd>Renvoie une liste <a href="/fr/docs/Web/API/MimeTypeArray"><code>MimeTypeArray</code></a> des types MIME pris en charge par le navigateur.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorOnLine.onLine"><code>NavigatorOnLine.onLine</code></a> {{readonlyInline}}</dt> - <dd>Renvoie un booléen indiquant si le navigateur est en ligne.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/permissions"><code>Navigator.permissions</code></a> {{readonlyinline}} {{experimental_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/Permissions"><code>Permissions</code></a> pouvant être utilisé pour demander ou mettre à jour les informations de permissions pour les API couvertes par l'API <a href="/en-US/docs/Web/API/Permissions_API">Permissions</a>.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorPlugins.plugins"><code>NavigatorPlugins.plugins</code></a> {{readonlyInline}}{{deprecated_inline}}</dt> - <dd>Renvoie une liste <a href="/fr/docs/Web/API/PluginArray"><code>PluginArray</code></a> indiquant les plugins installés sur le navigateur.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/presentation"><code>Navigator.presentation</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Renvoie une référence à l'API <a href="/fr/docs/Web/API/Presentation"><code>Presentation</code></a> .</dd> - <dt><a href="/fr/docs/Web/API/Navigator/serial"><code>Navigator.serial</code></a> {{readonlyInline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/Serial"><code>Serial</code></a> représentant le point d'entrée vers l'API <a href="/fr/docs/Web/API/Web Serial API"><code>Web Serial</code></a> qui permet de contrôler les ports série.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/serviceWorker"><code>Navigator.serviceWorker</code></a> {{readonlyInline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/ServiceWorkerContainer"><code>ServiceWorkerContainer</code></a> qui permet d'enregistrer, de supprimer, de mettre à jour ou de communiquer avec des objets <a href="/fr/docs/Web/API/ServiceWorker"><code>ServiceWorker</code></a> pour le <a href="https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window">document associé</a>.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorStorage.storage"><code>NavigatorStorage.storage</code></a> {{readonlyinline}}</dt> - <dd>Renvoie le singleton <a href="/fr/docs/Web/API/StorageManager"><code>StorageManager</code></a> utilisé pour la persistence des permissions et la gestion du stockage disponible site par site/application par application.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorID/userAgent"><code>NavigatorID.userAgent</code></a> {{readonlyInline}}</dt> - <dd>Renvoie la chaîne de caractères de l'agent utilisateur pour le navigateur courant.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/vendor"><code>Navigator.vendor</code></a> {{readonlyInline}}</dt> - <dd>Renvoie le nom de l'éditeur du navigateur courant (par exemple "Netscape6").</dd> - <dt><a href="/fr/docs/Web/API/Navigator/webdriver"><code>Navigator.webdriver</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Indique si l'agent utilisateur est contrôlé par un outil automatisé.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/xr"><code>Navigator.xr</code></a> {{readonlyInline}} {{experimental_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/XRSystem"><code>XRSystem</code></a> qui représente le point d'entrée sur l'API <a href="/en-US/docs/Web/API/WebXR_Device_API">WebXR</a>.</dd> -</dl> - -<h3 id="Non-standard_properties">Propriétés non-standard</h3> - -<dl> - <dt><a href="/fr/docs/Web/API/Navigator/buildID"><code>Navigator.buildID</code></a> {{non-standard_inline}}</dt> - <dd>Renvoie l'identifiant de build du navigateur. Les navigateurs renvoient un horodatage fixe pour éviter le pistage (par exemple <code>20181001000000</code> à partir de Firefox 64).</dd> - <dt><a href="/fr/docs/Web/API/Navigator/contacts"><code>Navigator.contacts</code></a> {{readonlyInline}} {{non-standard_inline}}</dt> - <dd>Renvoie une interface <a href="/fr/docs/Web/API/ContactsManager"><code>ContactsManager</code></a> qui permet à l'utilisateur de sélectionner certaines entrées dans la liste des contacts afin de partager certains détails limités avec une application web.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/securitypolicy"><code>Navigator.securitypolicy</code></a> {{non-standard_inline}}</dt> - <dd>Renvoie une chaîne de caractères vide. Netscape 4.7x renvoyait "US & CA domestic policy" ou "Export policy".</dd> - <dt><a href="/fr/docs/Web/API/Navigator/standalone"><code>Navigator.standalone</code></a> {{non-standard_inline}}</dt> - <dd>Renvoie un booléen indiquant si le navigateur s'exécute en mode <i>standalone</i>. Uniquement disponible sur Safari pour iOS.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/wakeLock"><code>Navigator.wakeLock</code></a> {{readonlyInline}} {{non-standard_inline}}</dt> - <dd>Renvoie une interface <a href="/fr/docs/Web/API/WakeLock"><code>WakeLock</code></a> pouvant être utilisée afin de demander un verrou sur l'écran afin de l'empêcher d'entrer en veille, de s'estomper ou de s'éteindre.</dd> -</dl> - -<h3 id="Deprecated_properties">Propriétés dépréciées</h3> - -<dl> - <dt><a href="/fr/docs/Web/API/NavigatorID/appCodeName"><code>NavigatorID.appCodeName</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie le nom de code interne du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorID/appName"><code>NavigatorID.appName</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie une chaîne <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a> contenant le nom officiel du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorID/appVersion"><code>NavigatorID.appVersion</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie la version du navigateur sous la forme d'une chaîne <a href="/fr/docs/Web/API/DOMString"><code>DOMString</code></a>. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/activeVRDisplays"><code>Navigator.activeVRDisplays</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie un tableau contenant chaque objet <a href="/fr/docs/Web/API/VRDisplay"><code>VRDisplay</code></a> actuellement utilisé pour afficher (autrement dit, pour chaque objet où <a href="/fr/docs/Web/API/VRDisplay.ispresenting"><code>VRDisplay.ispresenting</code></a> vaut <code>true</code>).</dd> - <dt><a href="/fr/docs/Web/API/Navigator/battery"><code>Navigator.battery</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie un objet <a href="/fr/docs/Web/API/BatteryManager"><code>BatteryManager</code></a> permettant d'avoir des informations sur le statut de charge de la batterie.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/oscpu"><code>Navigator.oscpu</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie une chaîne de caractères qui représente le système d'exploitation courant.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorID/platform"><code>NavigatorID.platform</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie une chaîne de caractères représentant la plateforme du navigateur. N'utilisez pas cette fonction afin d'obtenir une valeur significative.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorID/product"><code>NavigatorID.product</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie toujours <code>'Gecko'</code> quel que soit le navigateur. Cette propriété est uniquement conservée à des fins de compatibilité.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/productSub"><code>Navigator.productSub</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie le numéro de <i>build</i> précis du navigateur (par exemple "20060909").</dd> - <dt><a href="/fr/docs/Web/API/Navigator/vendorSub"><code>Navigator.vendorSub</code></a> {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>Renvoie le numéro de version de l'éditeur (e.g. "6.1").</dd> -</dl> - -<h2 id="Methods">Méthodes</h2> - -<p><em>Cette interface n'hérite d'aucune méthode mais implémente celles définies par <a href="/fr/docs/Web/API/NavigatorID"><code>NavigatorID</code></a>, <a href="/fr/docs/Web/API/NavigatorContentUtils"><code>NavigatorContentUtils</code></a>, <a href="/fr/docs/Web/API/NavigatorUserMedia"><code>NavigatorUserMedia</code></a>, and <a href="/fr/docs/Web/API/NavigatorStorageUtils"><code>NavigatorStorageUtils</code></a>.</em></p> - -<dl> - <dt><a href="/fr/docs/Web/API/Navigator/canShare()"><code>Navigator.canShare()</code></a></dt> - <dd>Renvoie <code>true</code> si un appel à <code>Navigator.share()</code> réussirait.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/registerProtocolHandler()"><code>Navigator.registerProtocolHandler()</code></a></dt> - <dd>Permet aux sites web de s'enregistrer afin de gérer un protocole donné.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/requestMediaKeySystemAccess()"><code>Navigator.requestMediaKeySystemAccess()</code></a></dt> - <dd>Renvoie une promesse (<a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise"><code>Promise</code></a>) qui se résout en un objet <code>MediaKeySystemAccess</code>.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/sendBeacon()"><code>Navigator.sendBeacon()</code></a></dt> - <dd>Transfère, de façon asynchrone, une petite quantité de donnée avec HTTP depuis l'agent utilisateur vers un serveur web.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/share()"><code>Navigator.share()</code></a></dt> - <dd>Invoque la fonctionnalité native de partage pour la plateforme courant.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/vibrate()"><code>Navigator.vibrate()</code></a></dt> - <dd>Permet de faire vibrer l'appareil si celui-ci prend en charge cette fonctionnalité. Aucun effet n'est produit s'il n'y a pas de compatibilité.</dd> -</dl> - -<h3 id="Deprecated_methods">Méthodes dépréciées</h3> - -<dl> - <dt><a href="/fr/docs/Web/API/Navigator/getVRDisplays()"><code>Navigator.getVRDisplays()</code></a> {{deprecated_inline}}</dt> - <dd>Renvoie une promesse qui se résout en un tableau d'objets <a href="/fr/docs/Web/API/VRDisplay"><code>VRDisplay</code></a> représentant chacun un appareil de réalité virtuelle connecté à l'ordinateur.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/getUserMedia()"><code>Navigator.getUserMedia()</code></a> {{deprecated_inline}}</dt> - <dd>Après avoir demandé la permission à l'utilisateur, renvoie le flux audio ou vidéo associé à une caméra ou à un micro sur l'ordinateur local.</dd> - <dt><a href="/fr/docs/Web/API/Navigator/registerContentHandler()"><code>Navigator.registerContentHandler()</code></a> {{deprecated_inline}}</dt> - <dd>Permet aux sites web de s'enregistrer pour gérer certains types MIME.</dd> - <dt><a href="/fr/docs/Web/API/NavigatorID/taintEnabled()"><code>NavigatorID.taintEnabled()</code></a> {{deprecated_inline}}</dt> - <dd>Renvoie <code>false</code>. Les fonctions JavaScript jouant sur cet aspect ont été retirées avec JavaScript 1.2.</dd> -</dl> - -<h2 id="Specifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#the-navigator-object', 'the Navigator object')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<div>{{Compat("api.Navigator")}}</div> +{{APIRef("DOM")}} + +L'interface **`Navigator`** représente l'état et l'identité de l'agent utilisateur courant. Elle permet aux scripts de consulter ces informations et de s'enregistrer en vue de certaines activités. + +Un objet instanciant `Navigator` peut être récupéré grâce à la propriété en lecture seule [`window.navigator`](/fr/docs/Web/API/Window/navigator). + +## Propriétés + +_Cette interface n'hérite d'aucune propriété mais implémente celles définies par [`NavigatorID`](/fr/docs/Web/API/NavigatorID), [`NavigatorLanguage`](/fr/docs/Web/API/NavigatorLanguage), [`NavigatorOnLine`](/fr/docs/Web/API/NavigatorOnLine), [`NavigatorContentUtils`](/fr/docs/Web/API/NavigatorContentUtils), [`NavigatorStorage`](/fr/docs/Web/API/NavigatorStorage), [`NavigatorStorageUtils`](/fr/docs/Web/API/NavigatorStorageUtils), [`NavigatorConcurrentHardware`](/fr/docs/Web/API/NavigatorConcurrentHardware), [`NavigatorPlugins`](/fr/docs/Web/API/NavigatorPlugins) et [`NavigatorUserMedia`](/fr/docs/Web/API/NavigatorUserMedia)._ + +### Propriétés standard + +- [`Navigator.connection`](/fr/docs/Web/API/Navigator/connection) {{readonlyInline}} {{experimental_inline}} + - : Fournit un objet [`NetworkInformation`](/fr/docs/Web/API/NetworkInformation) contenant des informations quant à la connection réseau de l'appareil. +- [`Navigator.cookieEnabled`](/fr/docs/Web/API/Navigator/cookieEnabled) {{readonlyinline}} + - : Renvoie un booléen indiquant si l'ajout d'un cookie sera pris en compte. +- [`Navigator.credentials`](/fr/docs/Web/API/Navigator/credentials) {{readonlyInline}} + - : Renvoie l'interface [`CredentialsContainer`](/fr/docs/Web/API/CredentialsContainer) qui expose des méthodes pour la demande d'informations d'authentification et qui notifie l'agent utilisateur lors d'évènements particuliers tels que les connexions ou déconnexions. +- [`Navigator.deviceMemory`](/fr/docs/Web/API/Navigator/deviceMemory) {{readonlyInline}} {{experimental_inline}} + - : Renvoie la quantité de mémoire de l'appareil, exprimée en gigaoctets. Cette valeur est une approximation calculée en prenant la plus proche puissance de 2 puis en divisant le résultat par 1024. +- [`Navigator.doNotTrack`](/fr/docs/Web/API/Navigator/doNotTrack) {{readonlyInline}} {{experimental_inline}} + - : Indique le choix de l'utilisateur fournit pour la préférence _do-not-track_. Lorsque cette valeur vaut "1", l'application web ne devrait pas pister l'utilisateur. +- [`Navigator.geolocation`](/fr/docs/Web/API/Navigator/geolocation) {{readonlyInline}} + - : Renvoie un objet [`Geolocation`](/fr/docs/Web/API/Geolocation) permettant l'accès à l'emplacement géographique de l'appareil. +- [`NavigatorConcurrentHardware.hardwareConcurrency`](/fr/docs/Web/API/NavigatorConcurrentHardware.hardwareConcurrency) {{readonlyInline}} + - : Renvoie le nombre de cœurs logiques du processeur. +- [`NavigatorPlugins.javaEnabled`](/fr/docs/Web/API/NavigatorPlugins.javaEnabled) {{readonlyInline}} + - : Renvoie le booléen `false`. +- [`Navigator.keyboard`](/fr/docs/Web/API/Navigator.keyboard) {{readonlyinline}} {{experimental_inline}} + - : Renvoie un objet [`Keyboard`](/fr/docs/Web/API/Keyboard) qui permet d'accéder à des fonctions pour récupérer des informations sur la disposition du clavier et la capture de touches du clavier physique. +- [`NavigatorLanguage.language`](/fr/docs/Web/API/NavigatorLanguage.language) {{readonlyInline}} + - : Renvoie une chaîne de caractères [`DOMString`](/fr/docs/Web/API/DOMString) indiquant la langue préférée de l'utilisateur (qui correspond généralement à la langue utilisée pour l'interface utilisateur du navigateur). La valeur `null` est renvoyée si cette information est inconnue. +- [`NavigatorLanguage.languages`](/fr/docs/Web/API/NavigatorLanguage.languages) {{readonlyInline}} {{experimental_inline}} + - : Renvoie un tableau de chaînes [`DOMString`](/fr/docs/Web/API/DOMString) qui représente les langues connues de l'utilisateur, triées par ordre de préférence. +- [`Navigator.locks`](/fr/docs/Web/API/Navigator/locks) {{readonlyinline}} {{experimental_inline}} + - : Renvoie un objet [`LockManager`](/fr/docs/Web/API/LockManager) qui fournit des méthodes pour demander un nouvel objet [`Lock`](/fr/docs/Web/API/Lock) ou s'enquérir d'un objet [`Lock`](/fr/docs/Web/API/Lock) existant. +- [`Navigator.maxTouchPoints`](/fr/docs/Web/API/Navigator/maxTouchPoints) {{readonlyInline}} + - : Renvoie le nombre maximum de points de toucher simultanés possible pour l'appareil courant. +- [`Navigator.mediaCapabilities`](/fr/docs/Web/API/Navigator/mediaCapabilities) {{readonlyinline}} {{experimental_inline}} + - : Renvoie un objet [`MediaCapabilities`](/fr/docs/Web/API/MediaCapabilities) qui peut exposer des informations sur le décodage/l'encodage d'un format donné. +- [`Navigator.mediaDevices`](/fr/docs/Web/API/Navigator/mediaDevices) {{readonlyinline}} + - : Renvoie une référence vers un objet [`MediaDevices`](/fr/docs/Web/API/MediaDevices) permettant d'obtenir des informations à propos des appareils médias disponibles ([`MediaDevices.enumerateDevices()`](</fr/docs/Web/API/MediaDevices.enumerateDevices()>)), de déterminer les propriétés et contraintes prises en charge pour les médias sur cet agent utilisateur et cet ordinateur ([`MediaDevices.getSupportedConstraints()`](</fr/docs/Web/API/MediaDevices.getSupportedConstraints()>)), de demander l'accès au média via [`MediaDevices.getUserMedia()`](</fr/docs/Web/API/MediaDevices.getUserMedia()>). +- [`Navigator.mediaSession`](/fr/docs/Web/API/Navigator/mediaSession) {{readonlyinline}} {{experimental_inline}} + - : Renvoie un objet [`MediaSession`](/fr/docs/Web/API/MediaSession) pouvant être utilisé afin de fournir des métadonnées utilisées par le navigateur afin de présenter des informations sur le média en cours de lecture (par exemple pour les interfaces utilisateurs générales de contrôle des médias). +- [`NavigatorPlugins.mimeTypes`](/fr/docs/Web/API/NavigatorPlugins.mimeTypes) {{readonlyInline}}{{deprecated_inline}} + - : Renvoie une liste [`MimeTypeArray`](/fr/docs/Web/API/MimeTypeArray) des types MIME pris en charge par le navigateur. +- [`NavigatorOnLine.onLine`](/fr/docs/Web/API/NavigatorOnLine.onLine) {{readonlyInline}} + - : Renvoie un booléen indiquant si le navigateur est en ligne. +- [`Navigator.permissions`](/fr/docs/Web/API/Navigator/permissions) {{readonlyinline}} {{experimental_inline}} + - : Renvoie un objet [`Permissions`](/fr/docs/Web/API/Permissions) pouvant être utilisé pour demander ou mettre à jour les informations de permissions pour les API couvertes par l'API [Permissions](/en-US/docs/Web/API/Permissions_API). +- [`NavigatorPlugins.plugins`](/fr/docs/Web/API/NavigatorPlugins.plugins) {{readonlyInline}}{{deprecated_inline}} + - : Renvoie une liste [`PluginArray`](/fr/docs/Web/API/PluginArray) indiquant les plugins installés sur le navigateur. +- [`Navigator.presentation`](/fr/docs/Web/API/Navigator/presentation) {{readonlyInline}} {{experimental_inline}} + - : Renvoie une référence à l'API [`Presentation`](/fr/docs/Web/API/Presentation) . +- [`Navigator.serial`](/fr/docs/Web/API/Navigator/serial) {{readonlyInline}} + - : Renvoie un objet [`Serial`](/fr/docs/Web/API/Serial) représentant le point d'entrée vers l'API [`Web Serial`](</fr/docs/Web/API/Web Serial API>) qui permet de contrôler les ports série. +- [`Navigator.serviceWorker`](/fr/docs/Web/API/Navigator/serviceWorker) {{readonlyInline}} + - : Renvoie un objet [`ServiceWorkerContainer`](/fr/docs/Web/API/ServiceWorkerContainer) qui permet d'enregistrer, de supprimer, de mettre à jour ou de communiquer avec des objets [`ServiceWorker`](/fr/docs/Web/API/ServiceWorker) pour le [document associé](https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window). +- [`NavigatorStorage.storage`](/fr/docs/Web/API/NavigatorStorage.storage) {{readonlyinline}} + - : Renvoie le singleton [`StorageManager`](/fr/docs/Web/API/StorageManager) utilisé pour la persistence des permissions et la gestion du stockage disponible site par site/application par application. +- [`NavigatorID.userAgent`](/fr/docs/Web/API/NavigatorID/userAgent) {{readonlyInline}} + - : Renvoie la chaîne de caractères de l'agent utilisateur pour le navigateur courant. +- [`Navigator.vendor`](/fr/docs/Web/API/Navigator/vendor) {{readonlyInline}} + - : Renvoie le nom de l'éditeur du navigateur courant (par exemple "Netscape6"). +- [`Navigator.webdriver`](/fr/docs/Web/API/Navigator/webdriver) {{readonlyInline}} {{experimental_inline}} + - : Indique si l'agent utilisateur est contrôlé par un outil automatisé. +- [`Navigator.xr`](/fr/docs/Web/API/Navigator/xr) {{readonlyInline}} {{experimental_inline}} + - : Renvoie un objet [`XRSystem`](/fr/docs/Web/API/XRSystem) qui représente le point d'entrée sur l'API [WebXR](/en-US/docs/Web/API/WebXR_Device_API). + +### Propriétés non-standard + +- [`Navigator.buildID`](/fr/docs/Web/API/Navigator/buildID) {{non-standard_inline}} + - : Renvoie l'identifiant de build du navigateur. Les navigateurs renvoient un horodatage fixe pour éviter le pistage (par exemple `20181001000000` à partir de Firefox 64). +- [`Navigator.contacts`](/fr/docs/Web/API/Navigator/contacts) {{readonlyInline}} {{non-standard_inline}} + - : Renvoie une interface [`ContactsManager`](/fr/docs/Web/API/ContactsManager) qui permet à l'utilisateur de sélectionner certaines entrées dans la liste des contacts afin de partager certains détails limités avec une application web. +- [`Navigator.securitypolicy`](/fr/docs/Web/API/Navigator/securitypolicy) {{non-standard_inline}} + - : Renvoie une chaîne de caractères vide. Netscape 4.7x renvoyait "US & CA domestic policy" ou "Export policy". +- [`Navigator.standalone`](/fr/docs/Web/API/Navigator/standalone) {{non-standard_inline}} + - : Renvoie un booléen indiquant si le navigateur s'exécute en mode _standalone_. Uniquement disponible sur Safari pour iOS. +- [`Navigator.wakeLock`](/fr/docs/Web/API/Navigator/wakeLock) {{readonlyInline}} {{non-standard_inline}} + - : Renvoie une interface [`WakeLock`](/fr/docs/Web/API/WakeLock) pouvant être utilisée afin de demander un verrou sur l'écran afin de l'empêcher d'entrer en veille, de s'estomper ou de s'éteindre. + +### Propriétés dépréciées + +- [`NavigatorID.appCodeName`](/fr/docs/Web/API/NavigatorID/appCodeName) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie le nom de code interne du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte. +- [`NavigatorID.appName`](/fr/docs/Web/API/NavigatorID/appName) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie une chaîne [`DOMString`](/fr/docs/Web/API/DOMString) contenant le nom officiel du navigateur. Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte. +- [`NavigatorID.appVersion`](/fr/docs/Web/API/NavigatorID/appVersion) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie la version du navigateur sous la forme d'une chaîne [`DOMString`](/fr/docs/Web/API/DOMString). Ne vous attendez pas à ce que cette propriété renvoie une valeur correcte. +- [`Navigator.activeVRDisplays`](/fr/docs/Web/API/Navigator/activeVRDisplays) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie un tableau contenant chaque objet [`VRDisplay`](/fr/docs/Web/API/VRDisplay) actuellement utilisé pour afficher (autrement dit, pour chaque objet où [`VRDisplay.ispresenting`](/fr/docs/Web/API/VRDisplay.ispresenting) vaut `true`). +- [`Navigator.battery`](/fr/docs/Web/API/Navigator/battery) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie un objet [`BatteryManager`](/fr/docs/Web/API/BatteryManager) permettant d'avoir des informations sur le statut de charge de la batterie. +- [`Navigator.oscpu`](/fr/docs/Web/API/Navigator/oscpu) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie une chaîne de caractères qui représente le système d'exploitation courant. +- [`NavigatorID.platform`](/fr/docs/Web/API/NavigatorID/platform) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie une chaîne de caractères représentant la plateforme du navigateur. N'utilisez pas cette fonction afin d'obtenir une valeur significative. +- [`NavigatorID.product`](/fr/docs/Web/API/NavigatorID/product) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie toujours `'Gecko'` quel que soit le navigateur. Cette propriété est uniquement conservée à des fins de compatibilité. +- [`Navigator.productSub`](/fr/docs/Web/API/Navigator/productSub) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie le numéro de _build_ précis du navigateur (par exemple "20060909"). +- [`Navigator.vendorSub`](/fr/docs/Web/API/Navigator/vendorSub) {{readonlyInline}} {{deprecated_inline}} + - : Renvoie le numéro de version de l'éditeur (e.g. "6.1"). + +## Méthodes + +_Cette interface n'hérite d'aucune méthode mais implémente celles définies par [`NavigatorID`](/fr/docs/Web/API/NavigatorID), [`NavigatorContentUtils`](/fr/docs/Web/API/NavigatorContentUtils), [`NavigatorUserMedia`](/fr/docs/Web/API/NavigatorUserMedia), and [`NavigatorStorageUtils`](/fr/docs/Web/API/NavigatorStorageUtils)._ + +- [`Navigator.canShare()`](</fr/docs/Web/API/Navigator/canShare()>) + - : Renvoie `true` si un appel à `Navigator.share()` réussirait. +- [`Navigator.registerProtocolHandler()`](</fr/docs/Web/API/Navigator/registerProtocolHandler()>) + - : Permet aux sites web de s'enregistrer afin de gérer un protocole donné. +- [`Navigator.requestMediaKeySystemAccess()`](</fr/docs/Web/API/Navigator/requestMediaKeySystemAccess()>) + - : Renvoie une promesse ([`Promise`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Promise)) qui se résout en un objet `MediaKeySystemAccess`. +- [`Navigator.sendBeacon()`](</fr/docs/Web/API/Navigator/sendBeacon()>) + - : Transfère, de façon asynchrone, une petite quantité de donnée avec HTTP depuis l'agent utilisateur vers un serveur web. +- [`Navigator.share()`](</fr/docs/Web/API/Navigator/share()>) + - : Invoque la fonctionnalité native de partage pour la plateforme courant. +- [`Navigator.vibrate()`](</fr/docs/Web/API/Navigator/vibrate()>) + - : Permet de faire vibrer l'appareil si celui-ci prend en charge cette fonctionnalité. Aucun effet n'est produit s'il n'y a pas de compatibilité. + +### Méthodes dépréciées + +- [`Navigator.getVRDisplays()`](</fr/docs/Web/API/Navigator/getVRDisplays()>) {{deprecated_inline}} + - : Renvoie une promesse qui se résout en un tableau d'objets [`VRDisplay`](/fr/docs/Web/API/VRDisplay) représentant chacun un appareil de réalité virtuelle connecté à l'ordinateur. +- [`Navigator.getUserMedia()`](</fr/docs/Web/API/Navigator/getUserMedia()>) {{deprecated_inline}} + - : Après avoir demandé la permission à l'utilisateur, renvoie le flux audio ou vidéo associé à une caméra ou à un micro sur l'ordinateur local. +- [`Navigator.registerContentHandler()`](</fr/docs/Web/API/Navigator/registerContentHandler()>) {{deprecated_inline}} + - : Permet aux sites web de s'enregistrer pour gérer certains types MIME. +- [`NavigatorID.taintEnabled()`](</fr/docs/Web/API/NavigatorID/taintEnabled()>) {{deprecated_inline}} + - : Renvoie `false`. Les fonctions JavaScript jouant sur cet aspect ont été retirées avec JavaScript 1.2. + +## Spécifications + +| Spécification | Statut | Commentaires | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------ | +| {{SpecName('HTML WHATWG', '#the-navigator-object', 'the Navigator object')}} | {{Spec2('HTML WHATWG')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.Navigator")}} diff --git a/files/fr/web/api/navigator/mozislocallyavailable/index.md b/files/fr/web/api/navigator/mozislocallyavailable/index.md index 839ac2aeb0..71ac7e12fe 100644 --- a/files/fr/web/api/navigator/mozislocallyavailable/index.md +++ b/files/fr/web/api/navigator/mozislocallyavailable/index.md @@ -5,25 +5,32 @@ tags: - Référence_du_DOM_Gecko translation_of: Web/API/Navigator/mozIsLocallyAvailable --- -<p>{{ ApiRef() }}</p> -<h3 id="R.C3.A9sum.C3.A9">Résumé</h3> -<p>Permet de déterminer si une ressource donnée est disponible.</p> -<h3 id="Syntaxe">Syntaxe</h3> -<pre class="eval">window.navigator.isLocallyAvailable(<i>uri</i>,<i>ifOffline</i>); -</pre> -<ul> - <li><code>uri</code> est l'URI de la ressource dont la disponibilité doit être vérifiée, sous la forme d'une chaîne.</li> - <li><code>ifOffline</code> permet de spécifier si le cache de ressources hors ligne doit être vérifié ; indiquez <code>true</code> pour prendre en compte le cache de ressources hors ligne.</li> -</ul> -<h3 id="Exemple">Exemple</h3> -<pre class="eval">var disponible = navigator.isLocallyAvailable("my-image-file.png", true); -if (disponible) { - /* la ressource hors ligne est présente */ -} else { - alert("Certaines ressources nécessaires ne sont pas disponibles tant que vous ne serez pas connecté au réseau."); -} -</pre> -<h3 id="Notes">Notes</h3> -<p>{{ Note("Des exceptions de sécurité peuvent se produire si l\'URI demandée n\'est pas de la même origine.") }}</p> -<h3 id="Sp.C3.A9cification">Spécification</h3> -<p>Aucune ; cependant certaines informations sont disponibles : <a href="http://www.campd.org/stuff/Offline%20Cache.html">Marking Resources for Offline Use</a></p> +{{ ApiRef() }} + +### Résumé + +Permet de déterminer si une ressource donnée est disponible. + +### Syntaxe + + window.navigator.isLocallyAvailable(uri,ifOffline); + +- `uri` est l'URI de la ressource dont la disponibilité doit être vérifiée, sous la forme d'une chaîne. +- `ifOffline` permet de spécifier si le cache de ressources hors ligne doit être vérifié ; indiquez `true` pour prendre en compte le cache de ressources hors ligne. + +### Exemple + + var disponible = navigator.isLocallyAvailable("my-image-file.png", true); + if (disponible) { + /* la ressource hors ligne est présente */ + } else { + alert("Certaines ressources nécessaires ne sont pas disponibles tant que vous ne serez pas connecté au réseau."); + } + +### Notes + +{{ Note("Des exceptions de sécurité peuvent se produire si l\'URI demandée n\'est pas de la même origine.") }} + +### Spécification + +Aucune ; cependant certaines informations sont disponibles : [Marking Resources for Offline Use](http://www.campd.org/stuff/Offline%20Cache.html) diff --git a/files/fr/web/api/navigator/registerprotocolhandler/index.md b/files/fr/web/api/navigator/registerprotocolhandler/index.md index 25df0e4c12..b44da6ad1f 100644 --- a/files/fr/web/api/navigator/registerprotocolhandler/index.md +++ b/files/fr/web/api/navigator/registerprotocolhandler/index.md @@ -5,42 +5,36 @@ tags: - Firefox 3 translation_of: Web/API/Navigator/registerProtocolHandler --- -<p>{{ ApiRef() }}</p> +{{ ApiRef() }} -<h3 id="R.C3.A9sum.C3.A9">Résumé</h3> +### Résumé -<p>Permet aux sites web de s'enregistrer en tant que gestionnaires possibles pour des protocoles particuliers.</p> +Permet aux sites web de s'enregistrer en tant que gestionnaires possibles pour des protocoles particuliers. -<p>{{ Note("Un site web ne peut enregistrer de gestionnaires de protocoles que pour lui-même. Pour des raisons de sécurité, il n\'est pas possible pour une extension ou un site d\'enregistrer des gestionnaires de protocoles ciblant d\'autres sites.") }}</p> +{{ Note("Un site web ne peut enregistrer de gestionnaires de protocoles que pour lui-même. Pour des raisons de sécurité, il n\'est pas possible pour une extension ou un site d\'enregistrer des gestionnaires de protocoles ciblant d\'autres sites.") }} -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="eval">window.navigator.registerProtocolHandler(<em>protocole</em>,<em>uri</em>,<em>titre</em>); -</pre> + window.navigator.registerProtocolHandler(protocole,uri,titre); -<ul> - <li><code>protocole</code> est le protocole que le site désire gérer, sous la forme d'une chaîne.</li> - <li><code>uri</code> est l'URI du gestionnaire sous la forme d'une chaîne. Il peut contenir « %s » pour indiquer où insérer l'URI échappée du document à gérer, comme montré dans l'exemple plus bas.</li> - <li><code>titre</code> est le titre du gestionnaire présenté à l'utilisateur, sous la forme d'une chaîne.</li> -</ul> +- `protocole` est le protocole que le site désire gérer, sous la forme d'une chaîne. +- `uri` est l'URI du gestionnaire sous la forme d'une chaîne. Il peut contenir « %s » pour indiquer où insérer l'URI échappée du document à gérer, comme montré dans l'exemple plus bas. +- `titre` est le titre du gestionnaire présenté à l'utilisateur, sous la forme d'une chaîne. -<h3 id="Exemple">Exemple</h3> +### Exemple -<p>Si votre application web est située à <code>http://www.example.com</code>, vous pouvez enregistrer un gestionnaire de protocole lui permettant de gérer « mailto » comme ceci :</p> +Si votre application web est située à `http://www.example.com`, vous pouvez enregistrer un gestionnaire de protocole lui permettant de gérer « mailto » comme ceci : -<pre class="eval">navigator.registerProtocolHandler("mailto", - "<a href="https://www.example.com/?to=%s">https://www.example.com/?to=%s</a>", - "Example Mail"); -</pre> + navigator.registerProtocolHandler("mailto", + "https://www.example.com/?to=%s", + "Example Mail"); -<p>Ceci crée un gestionnaire permettant aux liens <code>mailto</code> de diriger l'utilisateur vers l'application web, en insérant l'adresse spécifiée dans le lien dans l'URL.</p> +Ceci crée un gestionnaire permettant aux liens `mailto` de diriger l'utilisateur vers l'application web, en insérant l'adresse spécifiée dans le lien dans l'URL. -<h3 id="Sp.C3.A9cification">Spécification</h3> +### Spécification -<p>Spécifié dans le <a href="http://whatwg.org/specs/web-apps/current-work/#custom-handlers">brouillon de travail Web Applications 1.0</a> du WHATWG.</p> +Spécifié dans le [brouillon de travail Web Applications 1.0](http://whatwg.org/specs/web-apps/current-work/#custom-handlers) du WHATWG. -<h3 id="Voir_.C3.A9galement">Voir également</h3> +### Voir également -<ul> - <li><a href="/fr/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers">Gestionnaires de protocoles web</a></li> -</ul> +- [Gestionnaires de protocoles web](/fr/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers) diff --git a/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md b/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md index 3ab6522963..efb4ff023c 100644 --- a/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md +++ b/files/fr/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.md @@ -3,109 +3,103 @@ title: Gestionnaires de protocoles web slug: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers translation_of: Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers --- +### Introduction +Il est relativement courant de voir des pages web lier des ressources utilisant des protocoles non-`http`. Prenons par exemple le protocole `mailto:` : -<h3 id="Introduction">Introduction</h3> + <a href="mailto:webmaster@example.com">Webmestre</a> -<p>Il est relativement courant de voir des pages web lier des ressources utilisant des protocoles non-<code>http</code>. Prenons par exemple le protocole <code>mailto:</code> :</p> +Les auteurs web peuvent utiliser un lien `mailto:` lorsqu'ils veulent fournir aux utilisateurs une manière pratique d'envoyer un courrier électronique, directement depuis la page web. Lorsque le lien est activé, le navigateur est supposé lancer l'application par défaut du bureau pour le courrier électronique. On pourrait appeler cela un gestionnaire de protocole*du bureau*. -<pre><a href="mailto:webmaster@example.com">Webmestre</a> -</pre> +Les gestionnaires de protocoles web permettent à des applications web de participer également à ce processus. Leur importance va grandissant au fur et à mesure que différents types d'applications migrent vers le web. De fait, un grand nombre d'applications de courrier déjà basées sur le web pourraient traiter un lien `mailto`. -<p>Les auteurs web peuvent utiliser un lien <code>mailto:</code> lorsqu'ils veulent fournir aux utilisateurs une manière pratique d'envoyer un courrier électronique, directement depuis la page web. Lorsque le lien est activé, le navigateur est supposé lancer l'application par défaut du bureau pour le courrier électronique. On pourrait appeler cela un gestionnaire de protocole<em>du bureau</em>.</p> +### Enregistrement -<p>Les gestionnaires de protocoles web permettent à des applications web de participer également à ce processus. Leur importance va grandissant au fur et à mesure que différents types d'applications migrent vers le web. De fait, un grand nombre d'applications de courrier déjà basées sur le web pourraient traiter un lien <code>mailto</code>.</p> +La définition d'une application web comme gestionnaire de protocole n'est pas un processus difficile. En gros, l'application web utilise [`registerProtocolHandler()`](/fr/DOM/window.navigator.registerProtocolHandler) pour s'enregistrer auprès du navigateur comme gestionnaire potentiel pour un protocole donné. Par exemple : -<h3 id="Enregistrement">Enregistrement</h3> + navigator.registerProtocolHandler("mailto", + "https://www.example.com/?uri=%s", + "Example Mail"); -<p>La définition d'une application web comme gestionnaire de protocole n'est pas un processus difficile. En gros, l'application web utilise <code><a href="/fr/DOM/window.navigator.registerProtocolHandler">registerProtocolHandler()</a></code> pour s'enregistrer auprès du navigateur comme gestionnaire potentiel pour un protocole donné. Par exemple :</p> +Où les paramètres sont : -<pre>navigator.registerProtocolHandler("mailto", - "https://www.example.com/?uri=%s", - "Example Mail"); -</pre> +- Le protocole. +- Le modèle d'URL, utilisé comme gestionnaire. Le « %s » sera remplacé par le `href` du lien et une requête GET sera exécutée sur l'URL résultante. +- Le nom du gestionnaire de protocole tel que présenté à l'utilisateur. -<p>Où les paramètres sont :</p> +Lorsqu'un navigateur exécutera ce code, il devra demander à l'utilisateur la permission d'autoriser l'application web à s'enregistrer comme gestionnaire du protocole. Firefox affichera une question dans une barre de notification : -<ul> - <li>Le protocole.</li> - <li>Le modèle d'URL, utilisé comme gestionnaire. Le « %s » sera remplacé par le <code>href</code> du lien et une requête GET sera exécutée sur l'URL résultante.</li> - <li>Le nom du gestionnaire de protocole tel que présenté à l'utilisateur.</li> -</ul> +![](protocolregister.png) -<p>Lorsqu'un navigateur exécutera ce code, il devra demander à l'utilisateur la permission d'autoriser l'application web à s'enregistrer comme gestionnaire du protocole. Firefox affichera une question dans une barre de notification :</p> +{{ Note() }} -<p><img alt="" src="protocolregister.png"></p> +#### Exemple -<p>{{ Note() }}</p> - -<h4 id="Exemple">Exemple</h4> - -<pre class="brush: html"><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<html lang="fr"> -<head> - <title>Web Protocol Handler Sample - Register</title> - <script type="text/javascript"> +```html +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html lang="fr"> +<head> + <title>Web Protocol Handler Sample - Register</title> + <script type="text/javascript"> navigator.registerProtocolHandler("fake", "http://starkravingfinkle.org/projects/wph/handler.php?value=%s", "Protocole fake"); - </script> -</head> -<body> - <h1>Exemple de gestionnaire de protocole web</h1> - <p>Cette page va installer un gestionnaire de protocole web pour le protocole <code>fake:</code>.</p> -</body> -</html> -</pre> + </script> +</head> +<body> + <h1>Exemple de gestionnaire de protocole web</h1> + <p>Cette page va installer un gestionnaire de protocole web pour le protocole <code>fake:</code>.</p> +</body> +</html> +``` -<h3 id="Activation">Activation</h3> +### Activation -<p>À présent, chaque fois que l'utilisateur activera un lien utilisant le protocole enregistré, le navigateur dirigera l'action vers l'URL spécifiée lors de l'enregistrement de l'application web. Firefox, par défaut, demandera à l'utilisateur avant d'effectuer cette action.</p> +À présent, chaque fois que l'utilisateur activera un lien utilisant le protocole enregistré, le navigateur dirigera l'action vers l'URL spécifiée lors de l'enregistrement de l'application web. Firefox, par défaut, demandera à l'utilisateur avant d'effectuer cette action. -<h4 id="Exemple_2">Exemple</h4> +#### Exemple -<pre class="brush: html"><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<html lang="fr"> -<head> - <title>Exemple de gestionnaire de protocole web — test</title> -</head> -<body> - <p>Hola, avez-vous déjà vu <a href="fake:ceci%20est%20un%20faux%20protocole">ceci</a> auparavant ?</p> -</body> -</html> -</pre> +```html +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html lang="fr"> +<head> + <title>Exemple de gestionnaire de protocole web — test</title> +</head> +<body> + <p>Hola, avez-vous déjà vu <a href="fake:ceci%20est%20un%20faux%20protocole">ceci</a> auparavant ?</p> +</body> +</html> +``` -<h3 id="Traitement">Traitement</h3> +### Traitement -<p>La phase suivante est le traitement de l'action. Le navigateur extrait le <code>href</code> du lien activé, le combine avec le modèle d'URL fourni lors de l'enregistrement et effectue une requête HTTP GET sur l'URL. Ainsi, avec les exemples précédents, le navigateur effectuerait une requête GET sur cette URL :</p> +La phase suivante est le traitement de l'action. Le navigateur extrait le `href` du lien activé, le combine avec le modèle d'URL fourni lors de l'enregistrement et effectue une requête HTTP GET sur l'URL. Ainsi, avec les exemples précédents, le navigateur effectuerait une requête GET sur cette URL : -<pre>http://starkravingfinkle.org/projects/wph/handler.php?value=fake:ceci%20est%20un%20faux%20protocole -</pre> + http://starkravingfinkle.org/projects/wph/handler.php?value=fake:ceci%20est%20un%20faux%20protocole -<p>Un code côté serveur peut extraire les paramètres de la chaîne de requête et effectuer l'action désirée.</p> +Un code côté serveur peut extraire les paramètres de la chaîne de requête et effectuer l'action désirée. -<p>{{ Note("Le code côté serveur reçoit le contenu <strong>entier</strong> de l\'attribut <code>href</code>. Cela signifie qu\'il devra traiter la chaîne pour retirer l\'indication de protocole des données.") }}</p> +{{ Note("Le code côté serveur reçoit le contenu <strong>entier</strong> de l\'attribut <code>href</code>. Cela signifie qu\'il devra traiter la chaîne pour retirer l\'indication de protocole des données.") }} -<h4 id="Exemple_3">Exemple</h4> +#### Exemple -<pre class="brush: html"><?php +```html +<?php $value = ""; if ( isset ( $_GET["value"] ) ) { $value = $_GET["value"]; } -?> - -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<html lang="fr"> -<head> - <title>Exemple de gestionnaire de protocole web</title> -</head> -<body> - <h1>Exemple de gestionnaire de protocole web — Gestionnaire</h1> - <p>Cette page est appelée lors de la gestion d'une action utilisant le protocole <code>fake:</code>. Voici les données reçues :</p> - <textarea> -<?php echo(urldecode($value)) ?> - </textarea> -</body> -</html> -</pre> - -<p> </p> +?> + +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<html lang="fr"> +<head> + <title>Exemple de gestionnaire de protocole web</title> +</head> +<body> + <h1>Exemple de gestionnaire de protocole web — Gestionnaire</h1> + <p>Cette page est appelée lors de la gestion d'une action utilisant le protocole <code>fake:</code>. Voici les données reçues :</p> + <textarea> +<?php echo(urldecode($value)) ?> + </textarea> +</body> +</html> +``` diff --git a/files/fr/web/api/navigator/sendbeacon/index.md b/files/fr/web/api/navigator/sendbeacon/index.md index ca4928b18b..567bbfb8da 100644 --- a/files/fr/web/api/navigator/sendbeacon/index.md +++ b/files/fr/web/api/navigator/sendbeacon/index.md @@ -12,44 +12,42 @@ tags: - sendBeacon translation_of: Web/API/Navigator/sendBeacon --- -<div>{{APIRef("HTML DOM")}}</div> +{{APIRef("HTML DOM")}} -<p>La méthode <code><strong>navigator.sendBeacon()</strong></code> peut être utilisée pour transférer une petite quantité de données de façon asynchrone via {{Glossary("HTTP")}} vers un serveur web.</p> +La méthode **`navigator.sendBeacon()`** peut être utilisée pour transférer une petite quantité de données de façon asynchrone via {{Glossary("HTTP")}} vers un serveur web. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">navigator.sendBeacon(<em>url</em>, <em>donnees</em>); -</pre> + navigator.sendBeacon(url, donnees); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>url</code></dt> - <dd>Le paramètre <code>url</code> indique l'URL résolue à laquelle les <code>donnees</code> seront transmises.</dd> -</dl> +- `url` + - : Le paramètre `url` indique l'URL résolue à laquelle les `donnees` seront transmises. -<dl> - <dt><code>donnees</code></dt> - <dd>Le paramètre <code>donnees</code> est un objet {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, ou {{domxref("FormData")}} qui contient les données à transmettre.</dd> -</dl> +<!----> -<h3 id="Valeurs_de_retour">Valeurs de retour</h3> +- `donnees` + - : Le paramètre `donnees` est un objet {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, ou {{domxref("FormData")}} qui contient les données à transmettre. -<p>La méthode <code><strong>sendBeacon()</strong></code> retourne <code>true</code> (vrai) si l'agent utilisateur est en mesure de mettre en file les données à transférer avec succès. Sinon, la méthode retourne <code>false</code> (faux).</p> +### Valeurs de retour -<h2 id="Description">Description</h2> +La méthode **`sendBeacon()`** retourne `true` (vrai) si l'agent utilisateur est en mesure de mettre en file les données à transférer avec succès. Sinon, la méthode retourne `false` (faux). -<p>Cette méthode répond aux besoins de certains codes analytiques ou de diagnostic qui tentent d'envoyer des données à un serveur web avant le déchargement (<em>unloading</em>) du document. Envoyer les données plus tôt pourrait résulter en une opportunité manquée de récolter des données. Toutefois, s'assurer que les données ont été envoyées pendant le déchargement du document est quelque chose qui a traditionnellement été difficile pour les développeurs, car les agents utilisateur ignorent généralement les requêtes {{domxref("XMLHttpRequest")}} faites à l'intérieur d'un gestionnaire d'événements {{event("unload")}}.</p> +## Description -<p>Afin de résoudre ce problème, les codes analytiques ou de diagnostic faisaient historiquement appel à une requête <code>XMLHttpRequest</code> synchrone dans un gestionnaire d'événements <code>unload</code> ou {{event("beforeunload")}} pour soumettre les données. La requête <code>XMLHttpRequest</code> synchrone bloque le processus de déchargement du document, ce qui à son tour fait paraître la navigation plus lente. Il n'y a rien que la page suivante peut faire pour éviter cette perception d'une mauvaise performance de chargement de page, et le résultat est que l'utilisateur perçoit la nouvelle page web comme étant lente à se charger, même si le vrai problème provient de la page précédente.</p> +Cette méthode répond aux besoins de certains codes analytiques ou de diagnostic qui tentent d'envoyer des données à un serveur web avant le déchargement (_unloading_) du document. Envoyer les données plus tôt pourrait résulter en une opportunité manquée de récolter des données. Toutefois, s'assurer que les données ont été envoyées pendant le déchargement du document est quelque chose qui a traditionnellement été difficile pour les développeurs, car les agents utilisateur ignorent généralement les requêtes {{domxref("XMLHttpRequest")}} faites à l'intérieur d'un gestionnaire d'événements {{event("unload")}}. -<p>Il y a des techniques de contournement qui ont été utilisées pour s'assurer que ce type de données est transmis. Une technique de ce genre est de retarder le déchargement de la page pour soumettre les données en créant un élément {{HTMLElement("img")}} et en mettant son attribut <code>src</code> dans le gestionnaire de déchargement. Puisque la plupart des agents utilisateur vont retarder le déchargement afin de compléter le chargement de l'image en attente, les données peuvent être transmises durant le déchargement. Une autre technique est de créer une boucle de no-op (aucune opération) pour plusieurs secondes à l'intérieur du gestionnaire de déchargement, afin de retarder le déchargement et soumettre les données au serveur.</p> +Afin de résoudre ce problème, les codes analytiques ou de diagnostic faisaient historiquement appel à une requête `XMLHttpRequest` synchrone dans un gestionnaire d'événements `unload` ou {{event("beforeunload")}} pour soumettre les données. La requête `XMLHttpRequest` synchrone bloque le processus de déchargement du document, ce qui à son tour fait paraître la navigation plus lente. Il n'y a rien que la page suivante peut faire pour éviter cette perception d'une mauvaise performance de chargement de page, et le résultat est que l'utilisateur perçoit la nouvelle page web comme étant lente à se charger, même si le vrai problème provient de la page précédente. -<p>Non seulement ces techniques représentent-elles de mauvais patrons de programmation, certaines d'entre elles sont peu fiables, et elles résultent toutes en une perception d'une mauvaise performance de chargement de page pour la prochaine navigation.</p> +Il y a des techniques de contournement qui ont été utilisées pour s'assurer que ce type de données est transmis. Une technique de ce genre est de retarder le déchargement de la page pour soumettre les données en créant un élément {{HTMLElement("img")}} et en mettant son attribut `src` dans le gestionnaire de déchargement. Puisque la plupart des agents utilisateur vont retarder le déchargement afin de compléter le chargement de l'image en attente, les données peuvent être transmises durant le déchargement. Une autre technique est de créer une boucle de no-op (aucune opération) pour plusieurs secondes à l'intérieur du gestionnaire de déchargement, afin de retarder le déchargement et soumettre les données au serveur. -<p>L'exemple suivant montre un code analytique théorique qui tente de soumettre des données à un serveur en utilisant une requête <code>XMLHttpRequest</code> synchrone dans un gestionnaire de déchargement. Cela résulte en un délai pour le déchargement de la page.</p> +Non seulement ces techniques représentent-elles de mauvais patrons de programmation, certaines d'entre elles sont peu fiables, et elles résultent toutes en une perception d'une mauvaise performance de chargement de page pour la prochaine navigation. -<pre class="brush: js">window.addEventListener('unload', enregistrerDonnees, false); +L'exemple suivant montre un code analytique théorique qui tente de soumettre des données à un serveur en utilisant une requête `XMLHttpRequest` synchrone dans un gestionnaire de déchargement. Cela résulte en un délai pour le déchargement de la page. + +```js +window.addEventListener('unload', enregistrerDonnees, false); function enregistrerDonnees() { var client = new XMLHttpRequest(); @@ -57,43 +55,31 @@ function enregistrerDonnees() { client.setRequestHeader("Content-Type", "text/plain;charset=UTF-8"); client.send(donneesAnalytiques); } -</pre> +``` -<p>C'est là qu'entre en jeu <code><strong>sendBeacon()</strong></code>. En utilisant la méthode <code>sendBeacon()</code>, les données sont transmises de façon asynchrone au serveur web lorsque l'Agent Utilisateur a l'opportunité de le faire, sans retarder le déchargement ou affecter la performance de la navigation suivante. Cela résoud tous les problèmes avec la soumission de données analytiques : les données sont envoyées de façon fiable, asynchrone, et cela n'impacte pas le chargement de la page suivante. De plus, ce code est en fait plus simple à écrire que n'importe quelle de ces autres techniques!</p> +C'est là qu'entre en jeu **`sendBeacon()`**. En utilisant la méthode `sendBeacon()`, les données sont transmises de façon asynchrone au serveur web lorsque l'Agent Utilisateur a l'opportunité de le faire, sans retarder le déchargement ou affecter la performance de la navigation suivante. Cela résoud tous les problèmes avec la soumission de données analytiques : les données sont envoyées de façon fiable, asynchrone, et cela n'impacte pas le chargement de la page suivante. De plus, ce code est en fait plus simple à écrire que n'importe quelle de ces autres techniques! -<p>L'exemple suivant montre un patron de code analytique théorique qui soumet des données à un serveur en utilisant la méthode <code>sendBeacon()</code>.</p> +L'exemple suivant montre un patron de code analytique théorique qui soumet des données à un serveur en utilisant la méthode `sendBeacon()`. -<pre class="brush: js">window.addEventListener('unload', enregistrerDonnees, false); +```js +window.addEventListener('unload', enregistrerDonnees, false); function enregistrerDonnees() { navigator.sendBeacon("/log", donneesAnalytiques); } -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('Beacon', '#sec-sendBeacon-method', 'sendBeacon()')}}</td> - <td>{{Spec2('Beacon')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_avec_les_navigateurs">Compatibilité avec les navigateurs</h2> - -<p>{{Compat("api.Navigator.sendBeacon")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("navigator", "navigator")}}</li> - <li>{{domxref("WorkerNavigator.sendBeacon()")}} (Utilisation de <code>sendBeacon()</code> dans des <em>workers</em>)</li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | ------------------------ | ------------------- | +| {{SpecName('Beacon', '#sec-sendBeacon-method', 'sendBeacon()')}} | {{Spec2('Beacon')}} | Définition initiale | + +## Compatibilité avec les navigateurs + +{{Compat("api.Navigator.sendBeacon")}} + +## Voir aussi + +- {{domxref("navigator", "navigator")}} +- {{domxref("WorkerNavigator.sendBeacon()")}} (Utilisation de `sendBeacon()` dans des *workers*) diff --git a/files/fr/web/api/navigator/serviceworker/index.md b/files/fr/web/api/navigator/serviceworker/index.md index b00e6886fc..2ecbc2d5e0 100644 --- a/files/fr/web/api/navigator/serviceworker/index.md +++ b/files/fr/web/api/navigator/serviceworker/index.md @@ -11,55 +11,41 @@ tags: - ServiceWorker translation_of: Web/API/Navigator/serviceWorker --- -<p>{{APIRef("Service Workers API")}}</p> +{{APIRef("Service Workers API")}} -<p>Le <code><strong>Navigator.serviceWorker</strong></code> est une propriété en lecture seule qui renvoie un objet {{domxref("ServiceWorkerContainer")}}, et qui permet d'accéder à l'enregistrement, la suppression, la mise à jour, et la communication avec les objets {{domxref("ServiceWorker")}} pour le <a href="https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window">document associé</a>.</p> +Le **`Navigator.serviceWorker`** est une propriété en lecture seule qui renvoie un objet {{domxref("ServiceWorkerContainer")}}, et qui permet d'accéder à l'enregistrement, la suppression, la mise à jour, et la communication avec les objets {{domxref("ServiceWorker")}} pour le [document associé](https://html.spec.whatwg.org/multipage/browsers.html#concept-document-window). -<h2 id="syntaxe">syntaxe</h2> +## syntaxe -<pre class="syntaxbox">var workerContainerInstance = navigator.serviceWorker; -</pre> + var workerContainerInstance = navigator.serviceWorker; -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>L'objet {{domxref("ServiceWorkerContainer")}}.</p> +L'objet {{domxref("ServiceWorkerContainer")}}. -<p> </p> -<h2 id="Exemples">Exemples</h2> -<p>Le code ci-dessous vérifie si le navigateur supporte les service workers.</p> +## Exemples -<pre><code>if ('serviceWorker' in navigator) { - // Supported! -}</code></pre> +Le code ci-dessous vérifie si le navigateur supporte les service workers. -<p> </p> + if ('serviceWorker' in navigator) { + // Supported! + } -<h2 id="Spécifications">Spécifications</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('Service Workers', '#navigator-service-worker', 'navigator.serviceWorker')}}</td> - <td>{{Spec2('Service Workers')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Spécifications -<p>{{Compat("api.Navigator.serviceWorker")}}</p> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------- | +| {{SpecName('Service Workers', '#navigator-service-worker', 'navigator.serviceWorker')}} | {{Spec2('Service Workers')}} | Définition initiale. | -<h2 id="Voir_aussi">Voir aussi</h2> +## Compatibilité du navigateur -<ul> - <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> - <li><a href="/en-US/docs/Web/API/ServiceWorker_API/Using_Service_Workers">Utilisation de Service Workers</a></li> -</ul> +{{Compat("api.Navigator.serviceWorker")}} + +## Voir aussi + +- [ServiceWorker API](/en-US/docs/Web/API/ServiceWorker_API) +- [Utilisation de Service Workers](/en-US/docs/Web/API/ServiceWorker_API/Using_Service_Workers) diff --git a/files/fr/web/api/navigator/share/index.md b/files/fr/web/api/navigator/share/index.md index 041163cac3..7e2679be73 100644 --- a/files/fr/web/api/navigator/share/index.md +++ b/files/fr/web/api/navigator/share/index.md @@ -3,66 +3,49 @@ title: Navigator.share slug: Web/API/Navigator/share translation_of: Web/API/Navigator/share --- -<div>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</div> +{{APIRef("HTML DOM")}}{{SeeCompatTable}} -<p>La méthode <strong><code>Navigator.share()</code></strong> invoque le mécanisme de partage natif de l'appareil. Celle-ci appartient à l'API Web Share. Si l'API Web Share n'est pas supportée, alors la méthode sera <code>undefined</code>.</p> +La méthode **`Navigator.share()`** invoque le mécanisme de partage natif de l'appareil. Celle-ci appartient à l'API Web Share. Si l'API Web Share n'est pas supportée, alors la méthode sera `undefined`. -<h2 id="Syntax">Syntax</h2> +## Syntax -<pre class="syntaxbox">var sharePromise = window.navigator.share(<var>data</var>); -</pre> + var sharePromise = window.navigator.share(data); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><var>data</var></dt> - <dd>Un objet contenant les données à partager. Au moins un des champs suivant doit être spécifié. Les champs possibles sont les suivant : </dd> -</dl> +- _data_ + - : Un objet contenant les données à partager. Au moins un des champs suivant doit être spécifié. Les champs possibles sont les suivant : -<ul> - <li><code>url</code>: Un {{domxref("USVString")}} représentant l'URL à partager.</li> - <li><code>text</code>: Un {{domxref("USVString")}} représentant le texte à partager.</li> - <li><code>title</code>: Un {{domxref("USVString")}} représentant le titre à partager.</li> -</ul> +<!----> -<dl> -</dl> +- `url`: Un {{domxref("USVString")}} représentant l'URL à partager. +- `text`: Un {{domxref("USVString")}} représentant le texte à partager. +- `title`: Un {{domxref("USVString")}} représentant le titre à partager. -<h3 id="Valeur_retournée">Valeur retournée</h3> +<!----> -<p>Une {{domxref("Promise")}} qui sera résolue une fois que l'utilisateur aura finalisé son action de partage. Elle sera rejetée immédiatement si le paramètre <var>data</var> n'est pas correctement spécifié.</p> +### Valeur retournée -<p>Par exemple, sur Chrome pour Android, la <code>Promise</code> retournée sera résolue après que l'utilisateur ait choisi une application vers où partager ses données.</p> +Une {{domxref("Promise")}} qui sera résolue une fois que l'utilisateur aura finalisé son action de partage. Elle sera rejetée immédiatement si le paramètre _data_ n'est pas correctement spécifié. -<h2 id="Examples">Examples</h2> +Par exemple, sur Chrome pour Android, la `Promise` retournée sera résolue après que l'utilisateur ait choisi une application vers où partager ses données. -<pre class="brush: js">navigator.share({ +## Examples + +```js +navigator.share({ title: document.title, text: 'Hello World', url: 'https://developer.mozilla.org', -}); // partage l'URL de MDN</pre> - -<h2 id="Specifications">Specifications</h2> - -<table> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Web Share API','#share-method','share()')}}</td> - <td>{{Spec2('Web Share API')}}</td> - <td></td> - </tr> - </tbody> -</table> +}); // partage l'URL de MDN +``` -<h2 id="Browser_compatibility">Browser compatibility</h2> +## Specifications +| Specification | Status | Comment | +| ------------------------------------------------------------------------ | ------------------------------------ | ------- | +| {{SpecName('Web Share API','#share-method','share()')}} | {{Spec2('Web Share API')}} | | +## Browser compatibility -<p>{{Compat("api.Navigator.share")}}</p> +{{Compat("api.Navigator.share")}} diff --git a/files/fr/web/api/navigator/vibrate/index.md b/files/fr/web/api/navigator/vibrate/index.md index 335b8adcf9..84b69eec7b 100644 --- a/files/fr/web/api/navigator/vibrate/index.md +++ b/files/fr/web/api/navigator/vibrate/index.md @@ -3,59 +3,55 @@ title: Navigator.vibrate() slug: Web/API/Navigator/vibrate translation_of: Web/API/Navigator/vibrate --- -<p>{{APIRef("Vibration API")}}</p> +{{APIRef("Vibration API")}} -<p>La méthode <strong><code>Navigator.vibrate()</code></strong> active le module matériel de vibration de l'appareil, si ce dernier est présent. Si l'appareil ne supporte pas les vibrations, cette méthode n'a aucun effet. Si une série de vibration est déjà en cours, la précédente série est stopée et la nouvelle série est lancée.</p> +La méthode **`Navigator.vibrate()`** active le module matériel de vibration de l'appareil, si ce dernier est présent. Si l'appareil ne supporte pas les vibrations, cette méthode n'a aucun effet. Si une série de vibration est déjà en cours, la précédente série est stopée et la nouvelle série est lancée. -<p>Si la méthode ne peut pas vibrer en raison d'arguments invalides, elle retournera <code>false</code>, sinon elle retournera <code>true</code>. Si la série contient de trop longue vibration, elle sera tronqué; la longueur maximale dépend de l'implémentation.</p> +Si la méthode ne peut pas vibrer en raison d'arguments invalides, elle retournera `false`, sinon elle retournera `true`. Si la série contient de trop longue vibration, elle sera tronqué; la longueur maximale dépend de l'implémentation. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var <em>successBool</em> = window.navigator.vibrate(motif); -</pre> + var successBool = window.navigator.vibrate(motif); -<dl> - <dt><code>motif</code></dt> - <dd>Fournit un motif de vibration et d'intervalle de pause. Chaque valeur indique un nombre de milisecondes de vibration ou de pause, en alternance. Vous pouvez fournir une valeur (pour vibrer une fois) ou un tableau de valeur (vibration, pause, vibration ...). Voir l'<a href="/fr/docs/Web/API/Vibration_API">API Vibration</a> pour plus de détails.</dd> -</dl> +- `motif` + - : Fournit un motif de vibration et d'intervalle de pause. Chaque valeur indique un nombre de milisecondes de vibration ou de pause, en alternance. Vous pouvez fournir une valeur (pour vibrer une fois) ou un tableau de valeur (vibration, pause, vibration ...). Voir l'[API Vibration](/fr/docs/Web/API/Vibration_API) pour plus de détails. -<p>Passer la valeur 0, un tableau vide, ou un tableau de zéro arrêtera toutes les vibrations.</p> +Passer la valeur 0, un tableau vide, ou un tableau de zéro arrêtera toutes les vibrations. -<h2 id="Exemple">Exemple</h2> +## Exemple -<pre class="brush: js">window.navigator.vibrate(200); // vibre pendant 200ms +```js +window.navigator.vibrate(200); // vibre pendant 200ms window.navigator.vibrate([100,30,100,30,100,30,200,30,200,30,200,30,100,30,100,30,100]); // Vibre 'SOS' en Morse. -</pre> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications <table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Vibration API')}}</td> - <td>{{Spec2('Vibration API')}}</td> - <td> - <p>Linked to spec is the latest editor's draft; W3C version is a REC.</p> - </td> - </tr> - </tbody> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('Vibration API')}}</td> + <td>{{Spec2('Vibration API')}}</td> + <td> + <p> + Linked to spec is the latest editor's draft; W3C version is a REC. + </p> + </td> + </tr> + </tbody> </table> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.Navigator.vibrate")}} +## Voir aussi -<p>{{Compat("api.Navigator.vibrate")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/Vibration_API">Vibration API</a></li> -</ul> +- [Vibration API](/fr/docs/Web/API/Vibration_API) |