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/url/index.md | |
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/url/index.md')
-rw-r--r-- | files/fr/web/api/url/index.md | 241 |
1 files changed, 113 insertions, 128 deletions
diff --git a/files/fr/web/api/url/index.md b/files/fr/web/api/url/index.md index 917fa44e1a..6113b65cc9 100644 --- a/files/fr/web/api/url/index.md +++ b/files/fr/web/api/url/index.md @@ -7,146 +7,131 @@ tags: - URL translation_of: Web/API/URL --- -<div>{{ApiRef("URL API")}}</div> +{{ApiRef("URL API")}} -<p>L'interface <strong><code>URL</code></strong><strong> </strong>représente un objet qui fournit des méthodes statiques utilisées pour créer des URL d'objet.</p> +L'interface **`URL`\*\*** \*\*représente un objet qui fournit des méthodes statiques utilisées pour créer des URL d'objet. -<p>Lors de l'utilisation d'un agent utilisateur dans lequel aucun constructeur n'a encore été implémenté, il est possible d'accéder à un objet en utilisant les propriétés {{domxref("Window.URL")}} (préfixées sur un navigateur basé sur Webkit tel que <code>Window.webkitURL</code>).</p> +Lors de l'utilisation d'un agent utilisateur dans lequel aucun constructeur n'a encore été implémenté, il est possible d'accéder à un objet en utilisant les propriétés {{domxref("Window.URL")}} (préfixées sur un navigateur basé sur Webkit tel que `Window.webkitURL`). -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Utilisation">Utilisation</h2> +## Utilisation -<p>Le constructeur prend un paramètre url et un paramètre de base facultatif à utiliser comme base si le paramètre url est une URL relative :</p> +Le constructeur prend un paramètre url et un paramètre de base facultatif à utiliser comme base si le paramètre url est une URL relative : -<pre class="brush: js">const url = new URL('../cats', 'http://www.example.com/dogs'); +```js +const url = new URL('../cats', 'http://www.example.com/dogs'); console.log(url.hostname); // "www.example.com" -console.log(url.pathname); // "/cats"</pre> +console.log(url.pathname); // "/cats" +``` -<p>Les propriétés de l'URL peuvent être définies pour construire l'URL :</p> +Les propriétés de l'URL peuvent être définies pour construire l'URL : -<pre class="brush: js">url.hash = 'tabby'; -console.log(url.href); // "http://www.example.com/cats#tabby"</pre> +```js +url.hash = 'tabby'; +console.log(url.href); // "http://www.example.com/cats#tabby" +``` -<p>Les URL seront encodées selon la norme RFC 3986:</p> +Les URL seront encodées selon la norme RFC 3986: -<pre class="brush: js">url.pathname = 'démonstration.html'; -console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html"</pre> +```js +url.pathname = 'démonstration.html'; +console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html" +``` -<p>L'interface {{domxref("URLSearchParams")}} peut être utilisée pour construire et manipuler la chaîne de requête de l'URL.</p> +L'interface {{domxref("URLSearchParams")}} peut être utilisée pour construire et manipuler la chaîne de requête de l'URL. -<p>Pour obtenir les paramètres de recherche à partir de l'URL de la fenêtre en cours :</p> +Pour obtenir les paramètres de recherche à partir de l'URL de la fenêtre en cours : -<pre class="brush: js">// https://some.site/?id=123 +```js +// https://some.site/?id=123 var parsedUrl = new URL(window.location.href); -console.log(parsedUrl.searchParams.get("id")); // 123</pre> - -<p>La méthode <code>stringifier</code> de l' <code>URL</code> est la propriété <code>href</code> , ainsi le constructeur peut être utilisé pour normaliser et encoder directement une URL :</p> - -<pre class="brush: js">const response = await fetch(new URL('http://www.example.com/démonstration.html'));</pre> - -<h2 id="Constructeur">Constructeur</h2> - -<dl> - <dt>{{domxref("URL.URL", "URL()")}} {{experimental_inline}}</dt> - <dd>Crée et retourne un objet <code>URL</code> composé des paramètres donnés.</dd> -</dl> - -<h2 id="Propriétés">Propriétés</h2> - -<dl> - <dt>{{domxref("URL.hash")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant un <code>'#'</code> suivi de l'identifiant du fragment de l'URL.</dd> - <dt>{{domxref("URL.host")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant l'hôte, c'est-à-dire le <em>hostname (nom d'hôte)</em>, <code>':'</code>et le <em>port</em> de l'URL.</dd> - <dt>{{domxref("URL.hostname")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant le domaine de l'URL.</dd> - <dt>{{domxref("URL.href")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant l'URL entière.</dd> -</dl> - -<dl> - <dt>{{domxref("URL.origin")}} {{readonlyInline}}</dt> - <dd>Retourne une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant l'origine de l'URL, c'est son schéma, son domaine et son port .</dd> -</dl> - -<dl> - <dt>{{domxref("URL.password")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant le mot de passe spécifié avant le nom du domaine.</dd> -</dl> - -<dl> - <dt>{{domxref("URL.pathname")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant une barre oblique initiale <code>'/'</code>suivie du chemin de l'URL.</dd> -</dl> - -<dl> - <dt>{{domxref("URL.port")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant le numéro de port de l'URL.</dd> -</dl> - -<dl> - <dt>{{domxref("URL.protocol")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant le schéma du protocole de l'URL, y compris le final <code>':'</code>.</dd> - <dt>{{domxref("URL.search")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant un <code>'?'</code> suivi par les paramètres de l'URL.</dd> - <dt>{{domxref("URL.searchParams")}}</dt> - <dd>Retourne un objet {{domxref("URLSearchParams")}} permettant d'accéder aux arguments de requête GET contenus dans l'URL.</dd> - <dt>{{domxref("URL.username")}}</dt> - <dd>Est une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant le nom d'utilisateur spécifié avant le nom de domaine.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<p><em>L'interface <code>URL</code> </em> implémente les méthodes définies dans <em>{{domxref("URLUtils")}}.</em></p> - -<dl> - <dt>{{domxref("URLUtils.toString()")}}</dt> - <dd>Retourne une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, mais il ne peut pas être utilisé pour modifier la valeur.</dd> - <dt>{{domxref("URL.toJSON()")}}</dt> - <dd>Retourne une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant l'URL entière. Il retourne la même chaîne que la propriété <code>href</code> .</dd> -</dl> - -<h2 id="Méthodes_statiques">Méthodes statiques</h2> - -<dl> - <dt>{{ domxref("URL.createObjectURL()") }}</dt> - <dd>Retourne une {{domxref("DOMString")}} <em>(chaîne de caractères)</em> contenant un "blob URL" unique ; c'est une URL avec <code>blob :</code> son schéma suivi d'une chaîne opaque identifiant de manière unique l'objet dans le navigateur.</dd> - <dt>{{ domxref("URL.revokeObjectURL()") }}</dt> - <dd>Révoque un objet URL précédemment créé avec {{domxref ("URL.createObjectURL ()")}}.</dd> -</dl> - -<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('File API', '#creating-revoking', 'URL')}}</td> - <td>{{Spec2('File API')}}</td> - <td>Ajoute les méthodes statiques <code>URL.createObjectURL()</code> et <code>URL.revokeObjectURL</code><code>()</code>.</td> - </tr> - <tr> - <td>{{SpecName('URL', '#api', 'API')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale (implémente <code>URLUtils</code>).</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.URL")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/URL_API">URL API</a></li> - <li><a href="/fr/docs/Learn/Common_questions/What_is_a_URL">Qu'est-ce qu'un URL ?</a></li> - <li>Propriété permettant d'obtenir un objet <code>URL</code> : {{domxref("Window.URL")}}.</li> - <li>{{domxref("URLSearchParams")}}.</li> -</ul> +console.log(parsedUrl.searchParams.get("id")); // 123 +``` + +La méthode `stringifier` de l' `URL` est la propriété `href` , ainsi le constructeur peut être utilisé pour normaliser et encoder directement une URL : + +```js +const response = await fetch(new URL('http://www.example.com/démonstration.html')); +``` + +## Constructeur + +- {{domxref("URL.URL", "URL()")}} {{experimental_inline}} + - : Crée et retourne un objet `URL` composé des paramètres donnés. + +## Propriétés + +- {{domxref("URL.hash")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant un `'#'` suivi de l'identifiant du fragment de l'URL. +- {{domxref("URL.host")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant l'hôte, c'est-à-dire le _hostname (nom d'hôte)_, `':'`et le _port_ de l'URL. +- {{domxref("URL.hostname")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant le domaine de l'URL. +- {{domxref("URL.href")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant l'URL entière. + +<!----> + +- {{domxref("URL.origin")}} {{readonlyInline}} + - : Retourne une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant l'origine de l'URL, c'est son schéma, son domaine et son port . + +<!----> + +- {{domxref("URL.password")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant le mot de passe spécifié avant le nom du domaine. + +<!----> + +- {{domxref("URL.pathname")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant une barre oblique initiale `'/'`suivie du chemin de l'URL. + +<!----> + +- {{domxref("URL.port")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant le numéro de port de l'URL. + +<!----> + +- {{domxref("URL.protocol")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant le schéma du protocole de l'URL, y compris le final `':'`. +- {{domxref("URL.search")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant un `'?'` suivi par les paramètres de l'URL. +- {{domxref("URL.searchParams")}} + - : Retourne un objet {{domxref("URLSearchParams")}} permettant d'accéder aux arguments de requête GET contenus dans l'URL. +- {{domxref("URL.username")}} + - : Est une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant le nom d'utilisateur spécifié avant le nom de domaine. + +## Méthodes + +*L'interface `URL` *implémente les méthodes définies dans _{{domxref("URLUtils")}}._ + +- {{domxref("URLUtils.toString()")}} + - : Retourne une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, mais il ne peut pas être utilisé pour modifier la valeur. +- {{domxref("URL.toJSON()")}} + - : Retourne une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant l'URL entière. Il retourne la même chaîne que la propriété `href` . + +## Méthodes statiques + +- {{ domxref("URL.createObjectURL()") }} + - : Retourne une {{domxref("DOMString")}} _(chaîne de caractères)_ contenant un "blob URL" unique ; c'est une URL avec `blob :` son schéma suivi d'une chaîne opaque identifiant de manière unique l'objet dans le navigateur. +- {{ domxref("URL.revokeObjectURL()") }} + - : Révoque un objet URL précédemment créé avec {{domxref ("URL.createObjectURL ()")}}. + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------- | +| {{SpecName('File API', '#creating-revoking', 'URL')}} | {{Spec2('File API')}} | Ajoute les méthodes statiques `URL.createObjectURL()` et ` URL.revokeObjectURL``() `. | +| {{SpecName('URL', '#api', 'API')}} | {{Spec2('URL')}} | Définition initiale (implémente `URLUtils`). | + +## Compatibilité des navigateurs + +{{Compat("api.URL")}} + +## Voir aussi + +- [URL API](/fr/docs/Web/API/URL_API) +- [Qu'est-ce qu'un URL ?](/fr/docs/Learn/Common_questions/What_is_a_URL) +- Propriété permettant d'obtenir un objet `URL` : {{domxref("Window.URL")}}. +- {{domxref("URLSearchParams")}}. |