1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
---
title: Location.reload()
slug: Web/API/Location/reload
tags:
- API
- HTML-DOM
- Location
- Metodă
translation_of: Web/API/Location/reload
---
<p>{{ APIRef("HTML DOM") }}</p>
<p>Metoda <code><strong>Location.reload()</strong></code> ponownie ładuje zasób z bieżącego adresu URL. Jej opcjonalnym i jednocześnie unikalnym parametrem jest parametr {{domxref("Boolean")}}. Jeśli przyjmie on wartość <code>true</code>, powoduje zawsze ponownie ładowanie strony z serwera. Jeśli jego wartość wynosi <code>false</code> lub nie jest zdefiniowana, przeglądarka<span id="result_box" lang="pl"><span> może ponownie załadować stronę z pamięci podręcznej.</span></span> <span id="result_box" lang="pl"><span>Poza domyślnym zachowaniem pamięci cache, flaga </span></span><code>forcedReload</code><span lang="pl"><span> wpływa również na to, jak niektóre przeglądarki obsługują pozycję przewijania strony: zwykłe przeładowanie próbuje przywrócić pozycję przewijania po ponownym załadowaniu strony, natomiast w trybie wymuszonym (gdy parametr jest ustawiony na wartość </span></span><code>true</code><span lang="pl"><span>) nowy DOM zostaje wczytany ze </span></span><code>scrollTop == 0</code>.</p>
<p>Jeśli przypisanie nie może się wydarzyć z powodu naruszenia bezpieczeństwa, zostanie zgłoszony wyjątek {{domxref("DOMException")}} typu <code>SECURITY_ERROR</code>. Dzieje się tak, gdy pochodzenie skryptu wywołującego metodę różni się od pochodzenia strony opisanej przez obiekt {{domxref("Location")}} (zazwyczaj kiedy skrypt jest hostowany na innej domenie).</p>
<h2 id="Składnia">Składnia</h2>
<pre class="syntaxbox"><em>object</em>.reload(<em>forcedReload</em>);
</pre>
<h3 id="Parametry">Parametry</h3>
<dl>
<dt><em>forcedReload</em> {{optional_inline}}</dt>
<dd>Jest flagą {{domxref("Boolean")}}, która przyjmując wartość <code>true</code>, zawsze powoduje przeładowanie strony z serwera. Jeśli jej wartość to <code>false</code> lub nie została ona zdefiniowana, przeglądarka może wczytać stronę z pamięci podręczniej (pamięci cache).</dd>
</dl>
<h2 id="Przykłady">Przykłady</h2>
<pre class="brush: js">// Przeładuj bieżącą stronę bez cache
window.location.reload(true);</pre>
<h2 id="Lista_specyfikacji">Lista specyfikacji</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specyfikacja</th>
<th scope="col">Status</th>
<th scope="col">Komentarz</th>
</tr>
<tr>
<td>{{SpecName('HTML WHATWG', "history.html#dom-location-reload", "Location.reload()")}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td>Bez zmian od {{SpecName("HTML5 W3C")}}.</td>
</tr>
<tr>
<td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-reload", "Location.reload()")}}</td>
<td>{{Spec2('HTML5 W3C')}}</td>
<td>Początkowa definicja.</td>
</tr>
</tbody>
</table>
<h2 id="Zgodność_przeglądarek">Zgodność przeglądarek</h2>
<p>{{Compat("api.Location.reload")}}</p>
<h2 id="Zobacz_także">Zobacz także</h2>
<ul>
<li>Interfejs {{domxref("Location")}}.</li>
<li>Podobne metody: {{domxref("Location.assign()")}} i {{domxref("Location.replace()")}}.</li>
</ul>
|