---
title: window.navigator.onLine
slug: DOM/window.navigator.onLine
translation_of: Web/API/NavigatorOnLine/onLine
---
<div>
 {{ApiRef}}</div>
<h2 id="Summary" name="Summary">Yhteenveto</h2>
<p>Palauttaa selaimen verkkotilan. Ominaisuus palauttaa boolean-arvon, joka on <code>true</code>, kun verkkoyhteys on päällä ja <code>false</code>, kun selain toimii erillissovelluksena. Ominaisuus lähettää päivityksiä aina kun selaimen kyky yhdistyä verkkoon muuttuu. Päivitys tapahtuu, kun käyttäjä seuraa linkkiä tai kun skripti pyytää etäsivua. Esimerkiksi ominaisuuden pitäisi palauttaa <code>false</code>, kun käyttäjä napsauttaa linkkiä pian internet-yhteyden katkeamisen jälkeen.</p>
<p>Selaimet toteuttavat tätä ominaisuutta eri tavoin.</p>
<p>Chrome- ja Safari-selaimissa, jos selain ei kykene yhdistämään paikallisverkkoon (LAN) tai reitittimeen, se on erillissovellus; kaikki muut tilat palauttavat arvon <code>true</code>. Joten samalla kun voit otaksua, että selain on erillissovelluksena, kun sa palauttaa arvon <code>false</code>, et voi olettaa, että pääset internettiin, kun se palauttaa arvon true. Voisit saada vääriä positiivisia, sellaisissa tapauksissa, kun tietokone käyttää virtuaalisointiohjelmistoa, jolla on virtuaalisia ethernet-adaptereja, jotka ovat aina "yhdistettynä". Jos haluat todella määrittää selaimen verkkotilan, niin sinun olisi sikis kehitettävä muita keinoja tarkistamiseen. Lisäoppia varten katso HTML5 Rocks article, <a class="external" href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html"> Working Off the Grid</a>.</p>
<p>Firefox- ja Internet Explorer-selaimissa selaimen kytkeminen offline-tilaan lähettää arvon <code>false</code>. Kaikki muut tilat palauttavat arvon <code>true</code>.</p>
<p>Voit nähdä verkkotilan muutokset kuuntelemalla tapahtumia kohteissa <code>window.onOnline</code> ja <code>window.onOffline</code>.</p>
<h2 id="Syntax" name="Syntax">Syntaksi</h2>
<pre class="syntaxbox"><em>online</em> = <em>window</em>.navigator.onLine;
</pre>
<p><code>online</code> on boolean-arvo <code>true</code> tai <code>false</code>.</p>
<h2 id="Example" name="Example">Esimerkki</h2>
<p>Katso <a class="external" href="http://html5-demos.appspot.com/static/navigator.onLine.html"> live-esimerkki</a>.</p>
<p>Sen tarkistamiseksi, että oletko verkossa, kysele <code>window.navigator.onLine</code>, kuten seuraavassa esimerkissä:</p>
<pre class="brush: js">if (navigator.onLine) {
  alert('online')
} else {
  alert('offline');
}</pre>
<p>Verkkotila-arvojen muutosten näkemiseksi kuuntele (käyttäen <code><a href="/en-US/docs/DOM/element.addEventListener" title="DOM/element.addEventListener">addEventListener</a></code>) tapatumia kohteessa <code>window.onOnline</code> ja <code>window.onOffline</code>, kuten seuraavassa esimerkissä:</p>
<pre class="brush: js">window.addEventListener("offline", function(e) {alert("offline");})

window.addEventListener("online", function(e) {alert("online");})
</pre>
<h2 id="Browser_compatibility" name="Browser_compatibility">Selainyhteensopivuus</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Ominaisuus</th>
    <th>Chrome**</th>
    <th>Firefox (Gecko)*</th>
    <th>Internet Explorer</th>
    <th>Opera*</th>
    <th>Safari (WebKit)</th>
   </tr>
   <tr>
    <td>Perustuki</td>
    <td>
     <p>Windows: 11<br>
      Mac: 14<br>
      Chrome OS: 13<br>
      Linux: Palauttaa aina arvon <code>true</code></p>
     <p>Historiaa varten katso <a class="external" href="http://crbug.com/7469" title="http://crbug.com/7469">crbug.com/7469</a></p>
    </td>
    <td>
     <p>{{CompatNo}}<br>
      {{bug("336359")}}<br>
      {{bug("426932")}}<br>
      {{bug("620472")}}</p>
     <p>{{bug("654579")}}</p>
    </td>
    <td>8***</td>
    <td>{{CompatNo}}</td>
    <td>5.0.4</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Ominaisuus</th>
    <th>Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>IE Phone</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Perustuki</td>
    <td>Android 2.2 (Vika WebView-komponentissa, katso julkaisu <a class="external" href="http://code.google.com/p/android/issues/detail?id=16760">16760</a>)</td>
    <td>{{CompatUnknown}}</td>
    <td>{{CompatUnknown}}</td>
    <td>{{CompatUnknown}}</td>
    <td>{{CompatUnknown}}</td>
   </tr>
  </tbody>
 </table>
</div>
<p>* Firefox 4, ja Opera 11.10 palauttaa arvon <code>true</code>, kun "Work Offline"-tila on pois käytöstä ja <code>false</code>, kun se on käytössä riippumatta todellisesta yhteydestä.</p>
<p>** Chrome-selaimen aiemmat versiot palattavat virheellisesti <code>true</code> kun selain ensin avataa, mutta se alkaa ilmoittaa oiken yhteysarvon ensimmäisen verkkotapahtuman jälkeen.</p>
<p>*** Selaimessa IE 8 "online"- ja "ofline"-tapahtumat nostettiin kohteessa document.body, selaimessa IE 9 - sekä kohteessa document.body että kohteessa window</p>
<h2 id="Notes" name="Notes">Kommentit</h2>
<p>Katso yksityiskohtaisempaa kuvausta tästä ominaisuudesta asiakirjasta <a href="/en-US/docs/Online_and_offline_events" title="Online_and_offline_events">Online/Offline Events‎</a> samoin kuin uusista offline-kohtaisista ominaisuuksista, jotka esiteltiin selaimessa Firefox 3.</p>
<h2 id="Specification" name="Specification">Spesifikaatio</h2>
<p>Kuvattu asiakirjassa <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#navigator.online">HTML 5 Working draft</a></p>
<h2 id="See_also" name="See_also">Katso myös</h2>
<ul>
 <li><a class="external" href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html">HTML5 Rocks: Working Off the Grid With HTML5 Offline</a></li>
 <li><a class="external" href="http://www.html5rocks.com/en/tutorials/offline/whats-offline/">HTML5 Rocks: "Offline": What does it mean and why should I care?</a></li>
 <li><a class="external" href="http://hacks.mozilla.org/2010/01/offline-web-applications/">Mozilla Blog: Offline Web Applications</a></li>
</ul>