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/location | |
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/location')
-rw-r--r-- | files/fr/web/api/location/assign/index.md | 68 | ||||
-rw-r--r-- | files/fr/web/api/location/index.md | 183 | ||||
-rw-r--r-- | files/fr/web/api/location/reload/index.md | 38 | ||||
-rw-r--r-- | files/fr/web/api/location/replace/index.md | 87 |
4 files changed, 165 insertions, 211 deletions
diff --git a/files/fr/web/api/location/assign/index.md b/files/fr/web/api/location/assign/index.md index 3e0476b3be..e12848af11 100644 --- a/files/fr/web/api/location/assign/index.md +++ b/files/fr/web/api/location/assign/index.md @@ -10,62 +10,42 @@ tags: - WebAPI translation_of: Web/API/Location/assign --- -<p>{{ APIRef("Location") }}</p> +{{ APIRef("Location") }} -<p>La méthode <code><strong>Location.assign()</strong></code> charge et affiche dans la fenêtre le document situé à l'URL spécifiée.</p> +La méthode **`Location.assign()`** charge et affiche dans la fenêtre le document situé à l'URL spécifiée. -<p>Si l'action est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type <code>SECURITY_ERROR</code> est lancée. Cela se produit si l'origine du script appelant est différente de l'origine de la page initialement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine.</p> +Si l'action est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type `SECURITY_ERROR` est lancée. Cela se produit si l'origine du script appelant est différente de l'origine de la page initialement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine. -<p>Si l'URL spécifiée n'est pas valide, une {{domxref("DOMException")}} de type <code>SYNTAX_ERROR</code> est lancée.</p> +Si l'URL spécifiée n'est pas valide, une {{domxref("DOMException")}} de type `SYNTAX_ERROR` est lancée. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>object</em>.assign(<em>url</em>); -</pre> + object.assign(url); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><em>url</em></dt> - <dd>Une {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer.</dd> -</dl> +- _url_ + - : Une {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer. -<h2 id="Examples">Examples</h2> +## Examples -<pre class="brush: js">// Navigue vers l'article Location.reload -document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');</pre> +```js +// Navigue vers l'article Location.reload +document.location.assign('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload'); +``` -<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">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Pas de différence avec {{SpecName("HTML5 W3C")}}.</td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#dom-location-assign", "Location.assign()")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#dom-location-assign", "Location.assign()")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | -<h2 id="Compatibilité">Compatibilité</h2> +## Compatibilité +{{Compat("api.Location.assign")}} +## Voir aussi -<p>{{Compat("api.Location.assign")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface {{domxref("Location")}} à laquelle appartient cette méthode.</li> - <li>Méthodes similaires : {{domxref("Location.replace()")}} et {{domxref("Location.reload()")}}.</li> -</ul> +- L'interface {{domxref("Location")}} à laquelle appartient cette méthode. +- Méthodes similaires : {{domxref("Location.replace()")}} et {{domxref("Location.reload()")}}. diff --git a/files/fr/web/api/location/index.md b/files/fr/web/api/location/index.md index dc4e6e6a36..3766646973 100644 --- a/files/fr/web/api/location/index.md +++ b/files/fr/web/api/location/index.md @@ -10,19 +10,22 @@ tags: - Reference translation_of: Web/API/Location --- -<div>{{APIRef("HTML DOM")}}</div> +{{APIRef("HTML DOM")}} -<p>L'interface <strong><code>Location</code></strong> représente l'emplacement de l'objet auquel elle est liée. Les changements effectués dessus sont reflétés sur l'objet lié. Les deux interfaces {{domxref("Document")}} et {{domxref("Window")}} sont liées à une <code>Location</code>, accessible via {{domxref("Document.location")}} et {{domxref("Window.location")}} respectivement.</p> +L'interface **`Location`** représente l'emplacement de l'objet auquel elle est liée. Les changements effectués dessus sont reflétés sur l'objet lié. Les deux interfaces {{domxref("Document")}} et {{domxref("Window")}} sont liées à une `Location`, accessible via {{domxref("Document.location")}} et {{domxref("Window.location")}} respectivement. -<h2 id="Anatomie_dune_Location">Anatomie d'une Location</h2> +## Anatomie d'une Location -<h3 id="HTML">HTML</h3> +### HTML -<pre class="brush: html"><span id="href" title="href"><span id="protocol" title="protocol">http:</span>//<span id="host" title="host"><span id="hostname" title="hostname">example.org</span>:<span id="port" title="port">8888</span></span><span id="pathname" title="pathname">/foo/bar</span><span id="search" title="search">?q=baz</span><span id="hash" title="hash">#bang</span></span></pre> +```html +<span id="href" title="href"><span id="protocol" title="protocol">http:</span>//<span id="host" title="host"><span id="hostname" title="hostname">example.org</span>:<span id="port" title="port">8888</span></span><span id="pathname" title="pathname">/foo/bar</span><span id="search" title="search">?q=baz</span><span id="hash" title="hash">#bang</span></span> +``` -<h3 id="CSS">CSS</h3> +### CSS -<pre class="brush: css">html, body {height:100%;} +```css +html, body {height:100%;} html {display:table; width:100%;} body {display:table-cell; text-align:center; vertical-align:middle; font-family:georgia; font-size:230%; line-height:1em; white-space:nowrap;} @@ -36,11 +39,13 @@ body {display:table-cell; text-align:center; vertical-align:middle; font-family: [title] [title] [title]:before {margin-top:3em;} [title]:hover, -:target {position:relative; z-index:1; outline:50em solid rgba(255,255,255,.8);}</pre> +:target {position:relative; z-index:1; outline:50em solid rgba(255,255,255,.8);} +``` -<h3 id="JavaScript">JavaScript</h3> +### JavaScript -<pre class="brush: js">[].forEach.call(document.querySelectorAll('[title][id]'), function (node) { +```js +[].forEach.call(document.querySelectorAll('[title][id]'), function (node) { node.addEventListener("click", function(e) { e.preventDefault(); e.stopPropagation(); @@ -53,59 +58,57 @@ body {display:table-cell; text-align:center; vertical-align:middle; font-family: e.stopPropagation(); window.location.hash = ''; }); -});</pre> - -<h3 id="Result">Result</h3> - -<p>{{EmbedLiveSample('Anatomy_Of_Location')}}</p> - -<h2 id="Propriétés">Propriétés</h2> - -<p><em>L'interface <code>Location</code> n'hérite d'aucune propriété, mais implémente celles de {{domxref("URLUtils")}}.</em></p> - -<dl> - <dt>{{domxref("Location.href")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant l'URL entière.</dd> - <dt>{{domxref("Location.protocol")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant le schéma de protocole de l'URL, incluant le <code>':'</code> final.</dd> - <dt>{{domxref("Location.host")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant l'hôte, c'est-à-dire le <em>domaine</em>, un <code>':'</code>, et le <em>numéro de port</em> de l'URL.</dd> - <dt>{{domxref("Location.hostname")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant le domaine de l'URL.</dd> - <dt>{{domxref("Location.port")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant le numéro de port de l'URL.</dd> - <dt>{{domxref("Location.pathname")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant un <code>'/'</code> initial suivi du chemin de l'URL.</dd> - <dt>{{domxref("Location.search")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant un <code>'?'</code> suivi des paramètres de l'URL. Les navigateurs moderne fournissent <a href="/en-US/docs/Web/API/URLSearchParams/get#Example">URLSearchParams</a> et <a href="/en-US/docs/Web/API/URL/searchParams#Example">URL.searchParams</a> pour faciliter l'analyse des paramètres de la chaîne de requête (querystring).</dd> - <dt>{{domxref("Location.hash")}}</dt> - <dd>Une {{domxref("DOMString")}} contenant un <code>'#'</code> suivi de <em>l'identifiant de fragment</em> de l'URL.</dd> - <dt>{{domxref("Location.username")}} {{Obsolete_Inline}}</dt> - <dd>Une {{domxref("DOMString")}} contenant le nom d'utilisateur spécifié avant le nom de domaine.</dd> - <dt>{{domxref("Location.password")}} {{Obsolete_Inline}}</dt> - <dd>Une {{domxref("DOMString")}} contenant le mot de passe spécifié avant le nom de domaine.</dd> - <dt>{{domxref("Location.origin")}} {{readOnlyInline}}</dt> - <dd>Retourne une {{domxref("DOMString")}} contenant la forme canonique de l'origine de la location.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<p><em>L'interface <code>Location</code> n'hérite d'aucune méthode, mais implémente celles de {{domxref("URLUtils")}}.</em></p> - -<dl> - <dt>{{domxref("Location.assign()")}}</dt> - <dd>Charge la ressource située à l'URL passée en paramètre.</dd> - <dt>{{domxref("Location.reload()")}}</dt> - <dd>Recharge la ressource depuis l'URL actuelle. Son unique paramètre facultatif est un <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Boolean">Boolean</a>, qui, s'il est <code>true</code>, implique que la page est toujours rechargée depuis le serveur. Si ce paramètre est <code>false</code> ou non spécifié, le navigateur peut éventuellement recharger la page depuis son cache.</dd> - <dt>{{domxref("Location.replace()")}}</dt> - <dd>Remplace la ressource actuelle par celle à l'URL passée en paramètre. la différence avec la méthode <code>assign()</code> est que, après avoir utilisé <code>replace()</code>, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne pourra pas utiliser le bouton <em>précédent</em> pour y revenir.</dd> - <dt>{{domxref("Location.toString()")}}</dt> - <dd>Retourne une {{domxref("DOMString")}} contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, sauf que <code>toString()</code> ne peut être utilisée pour modifier la valeur.</dd> -</dl> - -<h2 id="Exemples">Exemples</h2> - -<pre class="brush: js">// Crée un élèment ancre et utilise la propriété href dans le but de cet exemple +}); +``` + +### Result + +{{EmbedLiveSample('Anatomy_Of_Location')}} + +## Propriétés + +_L'interface `Location` n'hérite d'aucune propriété, mais implémente celles de {{domxref("URLUtils")}}._ + +- {{domxref("Location.href")}} + - : Une {{domxref("DOMString")}} contenant l'URL entière. +- {{domxref("Location.protocol")}} + - : Une {{domxref("DOMString")}} contenant le schéma de protocole de l'URL, incluant le `':'` final. +- {{domxref("Location.host")}} + - : Une {{domxref("DOMString")}} contenant l'hôte, c'est-à-dire le _domaine_, un `':'`, et le _numéro de port_ de l'URL. +- {{domxref("Location.hostname")}} + - : Une {{domxref("DOMString")}} contenant le domaine de l'URL. +- {{domxref("Location.port")}} + - : Une {{domxref("DOMString")}} contenant le numéro de port de l'URL. +- {{domxref("Location.pathname")}} + - : Une {{domxref("DOMString")}} contenant un `'/'` initial suivi du chemin de l'URL. +- {{domxref("Location.search")}} + - : Une {{domxref("DOMString")}} contenant un `'?'` suivi des paramètres de l'URL. Les navigateurs moderne fournissent [URLSearchParams](/en-US/docs/Web/API/URLSearchParams/get#Example) et [URL.searchParams](/en-US/docs/Web/API/URL/searchParams#Example) pour faciliter l'analyse des paramètres de la chaîne de requête (querystring). +- {{domxref("Location.hash")}} + - : Une {{domxref("DOMString")}} contenant un `'#'` suivi de _l'identifiant de fragment_ de l'URL. +- {{domxref("Location.username")}} {{Obsolete_Inline}} + - : Une {{domxref("DOMString")}} contenant le nom d'utilisateur spécifié avant le nom de domaine. +- {{domxref("Location.password")}} {{Obsolete_Inline}} + - : Une {{domxref("DOMString")}} contenant le mot de passe spécifié avant le nom de domaine. +- {{domxref("Location.origin")}} {{readOnlyInline}} + - : Retourne une {{domxref("DOMString")}} contenant la forme canonique de l'origine de la location. + +## Méthodes + +_L'interface `Location` n'hérite d'aucune méthode, mais implémente celles de {{domxref("URLUtils")}}._ + +- {{domxref("Location.assign()")}} + - : Charge la ressource située à l'URL passée en paramètre. +- {{domxref("Location.reload()")}} + - : Recharge la ressource depuis l'URL actuelle. Son unique paramètre facultatif est un [Boolean](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Boolean), qui, s'il est `true`, implique que la page est toujours rechargée depuis le serveur. Si ce paramètre est `false` ou non spécifié, le navigateur peut éventuellement recharger la page depuis son cache. +- {{domxref("Location.replace()")}} + - : Remplace la ressource actuelle par celle à l'URL passée en paramètre. la différence avec la méthode `assign()` est que, après avoir utilisé `replace()`, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne pourra pas utiliser le bouton _précédent_ pour y revenir. +- {{domxref("Location.toString()")}} + - : Retourne une {{domxref("DOMString")}} contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, sauf que `toString()` ne peut être utilisée pour modifier la valeur. + +## Exemples + +```js +// Crée un élèment ancre et utilise la propriété href dans le but de cet exemple // Une alternative plus correcte est de naviguer vers l'URL et d'utiliser document.location ou window.location var url = document.createElement('a'); url.href = 'https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container'; @@ -117,39 +120,21 @@ console.log(url.port); // 8080 console.log(url.pathname); // /en-US/search console.log(url.search); // ?q=URL console.log(url.hash); // #search-results-close-container -console.log(url.origin); // https://developer.mozilla.org:8080</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">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "history.html#the-location-interface", "Location")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Pas de différence avec {{SpecName("HTML5 W3C")}}.</td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité">Compatibilité</h2> - - - -<p>{{Compat("api.Location")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>Deux méthodes qui créent un objet <code>location</code> : {{domxref("Window.location")}} et {{domxref("Document.location")}}.</li> - <li>Interfaces liées aux URL: {{domxref("URL")}}, {{domxref("URLSearchParams")}} et {{domxref("HTMLHyperlinkElementUtils")}}.</li> -</ul> +console.log(url.origin); // https://developer.mozilla.org:8080 +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#the-location-interface", "Location")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#the-location-interface", "Location")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | + +## Compatibilité + +{{Compat("api.Location")}} + +## Voir aussi + +- Deux méthodes qui créent un objet `location` : {{domxref("Window.location")}} et {{domxref("Document.location")}}. +- Interfaces liées aux URL: {{domxref("URL")}}, {{domxref("URLSearchParams")}} et {{domxref("HTMLHyperlinkElementUtils")}}. diff --git a/files/fr/web/api/location/reload/index.md b/files/fr/web/api/location/reload/index.md index 76d94b1efd..2b38ab6b28 100644 --- a/files/fr/web/api/location/reload/index.md +++ b/files/fr/web/api/location/reload/index.md @@ -4,39 +4,37 @@ slug: Web/API/Location/reload translation_of: Web/API/Location/reload browser-compat: api.Location.reload --- -<div>{{ APIRef("HTML DOM") }}</div> +{{ APIRef("HTML DOM") }} -<p>La méthode <code><strong>Location.reload()</strong></code> recharge la ressource depuis l'URL actuelle.</p> +La méthode **`Location.reload()`** recharge la ressource depuis l'URL actuelle. -<p>Le rechargement peut être bloqué avec une exception <a href="/fr/docs/Web/API/DOMException"><code>DOMException</code></a> <code>SECURITY_ERROR</code>. Cela se produit si <a href="/fr/docs/Glossary/Origin">l'origine</a> du script qui invoque <code>location.reload()</code> est différente de l'origine de la page qui possède l'objet <a href="/fr/docs/Web/API/Location"><code>Location</code></a>. Voir <a href="/fr/docs/Web/Security/Same-origin_policy">les règles sur l'origine</a> pour plus d'informations.</p> +Le rechargement peut être bloqué avec une exception [`DOMException`](/fr/docs/Web/API/DOMException) `SECURITY_ERROR`. Cela se produit si [l'origine](/fr/docs/Glossary/Origin) du script qui invoque `location.reload()` est différente de l'origine de la page qui possède l'objet [`Location`](/fr/docs/Web/API/Location). Voir [les règles sur l'origine](/fr/docs/Web/Security/Same-origin_policy) pour plus d'informations. -<h2 id="syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js"> +```js location.reload(); -</pre> +``` -<h2 id="location.reload_n_a_pas_de_paramètre">location.reload() n'a pas de paramètre</h2> +## location.reload() n'a pas de paramètre -<p>Firefox prend en charge un paramètre booléen non-standard <a href="https://searchfox.org/mozilla-central/source/dom/base/Location.cpp#551"><code>forceGet</code></a> pour la méthode <code>location.reload()</code>, qui permet à Firefox de passer outre le cache et d'effectuer un rafraîchissement forcé du document. Toutefois, pour tous les autres navigateurs, tout argument utilisé en appelant <code>location.reload()</code> sera ignoré et n'aura aucun effet.</p> +Firefox prend en charge un paramètre booléen non-standard [`forceGet`](https://searchfox.org/mozilla-central/source/dom/base/Location.cpp#551) pour la méthode `location.reload()`, qui permet à Firefox de passer outre le cache et d'effectuer un rafraîchissement forcé du document. Toutefois, pour tous les autres navigateurs, tout argument utilisé en appelant `location.reload()` sera ignoré et n'aura aucun effet. -<p>Il est toutefois possible que vous rencontriez des occurrences de <code>location.reload(true)</code> dans du code existant basé sur l'hypothèse que ce rafraîchissement forcé aurait lieu dans tous les navigateurs. Une recherche GitHub "<code>location.reload(true)</code>" renvoie <a href="https://github.com/search?q=%22location.reload%28true%29%22&type=code">plusieurs centaines de milliers de résultats</a>.</p> +Il est toutefois possible que vous rencontriez des occurrences de `location.reload(true)` dans du code existant basé sur l'hypothèse que ce rafraîchissement forcé aurait lieu dans tous les navigateurs. Une recherche GitHub "`location.reload(true)`" renvoie [plusieurs centaines de milliers de résultats](https://github.com/search?q=%22location.reload%28true%29%22&type=code). -<p>Historiquement, une version de Netscape Navigator a introduit la prise en charge de cet argument et cela s'est retrouvé dans Firefox. À un moment, le groupe de travail du W3C sur les API Web <a href="https://www.w3.org/2005/06/tracker/webapi/issues/69">a ouvert le sujet</a> pour étudier son ajout à la spécification pour <code>location.reload()</code>. Toutefois, il n'a jamais été ajouté formellement.</p> +Historiquement, une version de Netscape Navigator a introduit la prise en charge de cet argument et cela s'est retrouvé dans Firefox. À un moment, le groupe de travail du W3C sur les API Web [a ouvert le sujet](https://www.w3.org/2005/06/tracker/webapi/issues/69) pour étudier son ajout à la spécification pour `location.reload()`. Toutefois, il n'a jamais été ajouté formellement. -<p>En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle <code>location.reload()</code> et n'en a en fait jamais fait partie.</p> +En résumé, ce paramètre booléen ne fait pas partie de la spécification actuelle `location.reload()` et n'en a en fait jamais fait partie. -<h2 id="spécifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'interface <a href="/fr/docs/Web/API/Location"><code>Location</code></a> à laquelle appartient cette méthode.</li> - <li>Des méthodes semblables : <a href="/fr/docs/Web/API/Location/assign"><code>Location.assign()</code></a> et <a href="/fr/docs/Web/API/Location/replace"><code>Location.replace()</code></a>.</li> -</ul> +- L'interface [`Location`](/fr/docs/Web/API/Location) à laquelle appartient cette méthode. +- Des méthodes semblables : [`Location.assign()`](/fr/docs/Web/API/Location/assign) et [`Location.replace()`](/fr/docs/Web/API/Location/replace). diff --git a/files/fr/web/api/location/replace/index.md b/files/fr/web/api/location/replace/index.md index 90fa954e20..0811c18b61 100644 --- a/files/fr/web/api/location/replace/index.md +++ b/files/fr/web/api/location/replace/index.md @@ -8,51 +8,42 @@ tags: - Reference translation_of: Web/API/Location/replace --- -<p>{{APIRef("Location")}}</p> -<p>La méthode <code><strong>Location.replace()</strong></code> remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode {{domxref("Location.assign","assign()")}} est que, après avoir utilisé <code>replace()</code>, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne sera pas en mesure d'utiliser le bouton <em>précédent</em> pour y revenir.</p> -<p>Si le remplacement est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type <code>SECURITY_ERROR</code> est lancée. Ceci se produit si l'origine du script appelant est différente de l'origine de la page originellement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine.</p> -<p>Si l'URL donnée n'est pas valide, une {{domxref("DOMException")}} de type <code>SYNTAX_ERROR</code> est lancée.</p> -<h2 id="Syntaxe">Syntaxe</h2> -<pre class="syntaxbox"><em>object</em>.replace(<em>url</em>); -</pre> -<h3 id="Paramètres">Paramètres</h3> -<dl> - <dt> - <em>url</em></dt> - <dd> - {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer.</dd> -</dl> -<h2 id="Exemples">Exemples</h2> -<pre class="brush: js">// Navigue vers l'article <em>Location.reload</em> en remplaçant la page actuelle -document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');</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">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "history.html#dom-location-replace", "Location.replace()")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Pas de différence avec {{SpecName("HTML5 W3C")}}.</td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', "browsers.html#dom-location-replace", "Location.replace()")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.IDBIndex")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>L'interface {{domxref("Location")}} à laquelle appartient cette méthode.</li> - <li>Méthodes similaires : {{domxref("Location.assign()")}} et {{domxref("Location.reload()")}}.</li> -</ul> +{{APIRef("Location")}} + +La méthode **`Location.replace()`** remplace la ressource actuelle par celle présente à l'URL donnée. La différence avec la méthode {{domxref("Location.assign","assign()")}} est que, après avoir utilisé `replace()`, la page actuelle ne sera pas enregistrée dans l'historique de session {{domxref("History")}}, ce qui signifie que l'utilisateur ne sera pas en mesure d'utiliser le bouton _précédent_ pour y revenir. + +Si le remplacement est impossible à cause d'une violation de sécurité, une {{domxref("DOMException")}} de type `SECURITY_ERROR` est lancée. Ceci se produit si l'origine du script appelant est différente de l'origine de la page originellement désignée par l'objet {{domxref("Location")}}, principalement quand le script est hébergé sur un autre domaine. + +Si l'URL donnée n'est pas valide, une {{domxref("DOMException")}} de type `SYNTAX_ERROR` est lancée. + +## Syntaxe + + object.replace(url); + +### Paramètres + +- _url_ + - : {{domxref("DOMString")}} contenant l'URL de la page vers laquelle naviguer. + +## Exemples + +```js +// Navigue vers l'article Location.reload en remplaçant la page actuelle +document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload'); +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------- | +| {{SpecName('HTML WHATWG', "history.html#dom-location-replace", "Location.replace()")}} | {{Spec2('HTML WHATWG')}} | Pas de différence avec {{SpecName("HTML5 W3C")}}. | +| {{SpecName('HTML5 W3C', "browsers.html#dom-location-replace", "Location.replace()")}} | {{Spec2('HTML5 W3C')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.IDBIndex")}} + +## Voir aussi + +- L'interface {{domxref("Location")}} à laquelle appartient cette méthode. +- Méthodes similaires : {{domxref("Location.assign()")}} et {{domxref("Location.reload()")}}. |