---
title: WifiManager.associate()
slug: Web/API/WifiManager/associate
tags:
  - API
  - B2G
  - Non Standard
  - WebAPI
translation_of: Archive/B2G_OS/API/WifiManager/associate
---
<div>{{APIRef("Firefox OS")}}{{non-standard_header}}</div>

<p>{{B2GOnlyHeader2('certified')}}</p>

<p>La méthode <strong><code>associate</code></strong> est utilisée pour associer (et connecter) un appareil avec un réseau WiFi donné.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre>var request = navigator.mozWifiManager.associate(network);</pre>

<h3 id="Paramètres">Paramètres</h3>

<dl>
 <dt><code>network</code></dt>
 <dd>Un objet réseau fournies par les méthode {{domxref("WifiManager.getNetworks","getNetworks")}} ou {{domxref("WifiManager.getKnownNetworks","getKnownNetworks")}}.</dd>
</dl>

<p>Association d'un réseau sécurisé avec un dispositif nécessitant la mise en oeuvre de propriétés supplémentaires sur l'objet <code>network</code> est passé à la méthode:</p>

<ul>
 <li>Pour le réseau avec la méthode de chiffrement WEP:
  <ul>
   <li><code>wep</code> : Cette propriété doit être définie avec le bon mot de passe pour accéder au réseau.</li>
  </ul>
 </li>
 <li>Pour le réseau avec la méthode de chiffrement WPA-PSK:
  <ul>
   <li><code>psk</code> : Cette propriété doit être définie avec le bon mot de passe pour accéder au réseau.</li>
  </ul>
 </li>
 <li>Pour le réseau avec la méthode de chiffrement WPA-EAP:
  <ul>
   <li><code>eap</code> : Une chaîne représentant la <a class="external external-icon" href="https://fr.wikipedia.org/wiki/Extensible_Authentication_Protocol#M.C3.A9thodes" title="http://en.wikipedia.org/wiki/Extensible_Authentication_Protocol#Methods">méthode EAP</a> à utiliser.</li>
   <li><code>password</code> : Une chaîne représentant le mot de passe pour accéder au réseau.</li>
   <li><code>identity</code> : Une chaîne représentant l'identité pour accéder au réseau.</li>
   <li><code>pin</code> : Une chaîne représentant le code PIN requis pour accéder au réseau.</li>
  </ul>
 </li>
</ul>

<h3 id="Résultats">Résultats</h3>

<p>Elle renvoie un objet <a href="https://developer.mozilla.org/fr/docs/Web/API/DOMRequest"><code>DOMRequest</code></a> gérant le succès ou l'echec de l'opération. Une opération réussie signifie que le dispositif entre dans le <a href="https://fr.wikipedia.org/wiki/Workflow">workflow</a> de connexion au réseau fourni. Le succès ou l'échec de la connexion elle-même peuvent être suivis à travers l'événement <code><a href="https://developer.mozilla.org/fr/docs/Web/Events/statuschange">statuschange</a></code> en attachant un gestionnaire d'événements à <a href="https://developer.mozilla.org/fr/docs/Web/API/WifiManager/onstatuschange" title="Indique un écouteur d'événement pour recevoir les événements de statuschange.  Ces événements se produisent lorsque la connexion WiFi changements d'état de l'appareil."><code>WifiManager.onstatuschange</code></a>.</p>

<h2 id="Spécification">Spécification</h2>

<p>Ne fait partie d'aucune spécification.</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>{{domxref("WifiManager")}}</li>
 <li>{{domxref("MozWifiStatusChangeEvent")}}</li>
 <li><a href="/fr/docs/WebAPI/WiFi_Information">WifI Information API</a></li>
</ul>