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 | |
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')
-rw-r--r-- | files/fr/web/api/url/createobjecturl/index.md | 117 | ||||
-rw-r--r-- | files/fr/web/api/url/hash/index.md | 58 | ||||
-rw-r--r-- | files/fr/web/api/url/index.md | 241 | ||||
-rw-r--r-- | files/fr/web/api/url/protocol/index.md | 55 | ||||
-rw-r--r-- | files/fr/web/api/url/revokeobjecturl/index.md | 63 | ||||
-rw-r--r-- | files/fr/web/api/url/search/index.md | 67 | ||||
-rw-r--r-- | files/fr/web/api/url/searchparams/index.md | 59 | ||||
-rw-r--r-- | files/fr/web/api/url/tojson/index.md | 50 | ||||
-rw-r--r-- | files/fr/web/api/url/tostring/index.md | 66 | ||||
-rw-r--r-- | files/fr/web/api/url/url/index.md | 98 |
10 files changed, 360 insertions, 514 deletions
diff --git a/files/fr/web/api/url/createobjecturl/index.md b/files/fr/web/api/url/createobjecturl/index.md index faca6b81b9..25ec39cb51 100644 --- a/files/fr/web/api/url/createobjecturl/index.md +++ b/files/fr/web/api/url/createobjecturl/index.md @@ -3,89 +3,86 @@ title: URL.createObjectURL slug: Web/API/URL/createObjectURL translation_of: Web/API/URL/createObjectURL --- +{{APIRef("URL")}} +La méthode statique **URL.createObjectURL()** crée une chaîne contenant une URL représentant l’objet passé en paramètre. La durée de vie de l’URL est liée au {{domxref("document")}} de la fenêtre depuis laquelle elle a été créée. La nouvelle URL d’objet représente l’objet {{domxref("File")}} ou {{domxref("Blob")}} spécifié. -<p>{{APIRef("URL")}}<br> - La méthode statique <strong>URL.createObjectURL()</strong> crée une chaîne contenant une URL représentant l’objet passé en paramètre. La durée de vie de l’URL est liée au {{domxref("document")}} de la fenêtre depuis laquelle elle a été créée. La nouvelle URL d’objet représente l’objet {{domxref("File")}} ou {{domxref("Blob")}} spécifié.</p> +Pour libérer une URL d’objet, il faut appeler {{domxref("URL.revokeObjectURL", "revokeObjectURL()")}} -<p>Pour libérer une URL d’objet, il faut appeler {{domxref("URL.revokeObjectURL", "revokeObjectURL()")}}</p> +{{AvailableInWorkers}} -<p>{{AvailableInWorkers}}</p> +> **Note :** Cette fonctionnalité n'est pas disponible dans les [Service Workers](/fr/docs/Web/API/ServiceWorker) à cause de possible fuite mémoire. -<div class="note"> -<p><strong>Note :</strong> Cette fonctionnalité n'est pas disponible dans les <a href="/fr/docs/Web/API/ServiceWorker">Service Workers</a> à cause de possible fuite mémoire.</p> -</div> +## Syntaxe -<h2 id="Syntax">Syntaxe</h2> + objectURL = URL.createObjectURL(object); -<pre class="syntaxbox"><em>objectURL</em> = URL.createObjectURL(<em>object</em>); -</pre> +### Paramètres -<h3 id="Paramètres">Paramètres</h3> +- `object` + - : Un objet {{domxref("File")}}, {{domxref("Blob")}} ou {{domxref("MediaSource")}} pour lequel créer une URL d’objet. -<dl> - <dt><code>object</code></dt> - <dd>Un objet {{domxref("File")}}, {{domxref("Blob")}} ou {{domxref("MediaSource")}} pour lequel créer une URL d’objet.</dd> -</dl> +### Valeur de retour -<h3 id="Valeur_de_retour">Valeur de retour</h3> +Une {{domxref("DOMString")}} contenant une URL d’objet, pouvant être utilisée comme une référence vers l’objet source `object` spécifié. -<p>Une {{domxref("DOMString")}} contenant une URL d’objet, pouvant être utilisée comme une référence vers l’objet source <code>object</code> spécifié.</p> +## Exemple -<h2 id="Example">Exemple</h2> +Voir [Utilisation de l’objet URLs pour afficher des images](/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images). -<p>Voir <a href="/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images">Utilisation de l’objet URLs pour afficher des images</a>.</p> +## Notes d’utilisation -<h2 id="Notes">Notes d’utilisation</h2> +### Gestion de la mémoire -<h3 id="Gestion_de_la_mémoire">Gestion de la mémoire</h3> +À chaque fois que vous appelez `createObjectURL()`, une nouvelle URL d’objet est créée, même si vous en avez déjà créée une pour le même objet. Chacune d’elles doit être libérée en appelant {{domxref("URL.revokeObjectURL()")}} lorsque vous n’en avez plus besoin. -<p>À chaque fois que vous appelez <code>createObjectURL()</code>, une nouvelle URL d’objet est créée, même si vous en avez déjà créée une pour le même objet. Chacune d’elles doit être libérée en appelant {{domxref("URL.revokeObjectURL()")}} lorsque vous n’en avez plus besoin.</p> +Les navigateurs libèrent automatiquement les URL d’objet lorsque le document est déchargé (_unload_) ; cependant, pour une performance et une utilisation de la mémoire optimales, si vous avez la possiblité de les libérer explictement sans danger, vous devriez le faire. -<p>Les navigateurs libèrent automatiquement les URL d’objet lorsque le document est déchargé (<em>unload</em>) ; cependant, pour une performance et une utilisation de la mémoire optimales, si vous avez la possiblité de les libérer explictement sans danger, vous devriez le faire.</p> +### Utiliser les URL d’objet pour les flux de média -<h3 id="Utiliser_les_URL_d’objet_pour_les_flux_de_média">Utiliser les URL d’objet pour les flux de média</h3> +Dans d’anciennes versions de la spécification de Media Source, attacher un flux à un élément {{HTMLElement("video")}} requiérait de créer une URL d’objet pour le {{domxref("MediaStream")}}. Cela n’est plus nécessaire, et les navigateurs cessent progressivement de supporter cette pratique. -<p>Dans d’anciennes versions de la spécification de Media Source, attacher un flux à un élément {{HTMLElement("video")}} requiérait de créer une URL d’objet pour le {{domxref("MediaStream")}}. Cela n’est plus nécessaire, et les navigateurs cessent progressivement de supporter cette pratique.</p> +> **Attention :** si vous avez toujours du code qui repose sur {{domxref("URL.createObjectURL")}} pour attacher des flux à des éléments média, vous devez mettre à jour votre code pour attacher simplement {{domxref("HTMLMediaElement.srcObject", "srcObject")}} directement au `MediaStream`. -<div class="warning"> -<p><strong>Attention :</strong> si vous avez toujours du code qui repose sur {{domxref("URL.createObjectURL")}} pour attacher des flux à des éléments média, vous devez mettre à jour votre code pour attacher simplement {{domxref("HTMLMediaElement.srcObject", "srcObject")}} directement au <code>MediaStream</code>.</p> -</div> - -<h2 id="Browser_Compatibility">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">Commentaire</th> - </tr> - <tr> - <td>{{SpecName("File API", "#dfn-createObjectURL", "createObjectURL()")}}</td> - <td>{{Spec2("File API")}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName("Media Source Extensions", "#dom-url-createobjecturl", "URL")}}</td> - <td>{{Spec2("Media Source Extensions")}}</td> - <td> - <p>Extension MediaSource.<br> - Les anciennes versions de cette spécification utilisaient <code>createObjectURL()</code> pour les objets {{domxref("MediaStream")}} ; ce n’est plus supporté.</p> - </td> - </tr> - </tbody> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + <tr> + <td> + {{SpecName("File API", "#dfn-createObjectURL", "createObjectURL()")}} + </td> + <td>{{Spec2("File API")}}</td> + <td>Définition initiale.</td> + </tr> + <tr> + <td> + {{SpecName("Media Source Extensions", "#dom-url-createobjecturl", "URL")}} + </td> + <td>{{Spec2("Media Source Extensions")}}</td> + <td> + <p> + Extension MediaSource.<br />Les anciennes versions de cette + spécification utilisaient <code>createObjectURL()</code> pour les + objets {{domxref("MediaStream")}} ; ce n’est plus supporté. + </p> + </td> + </tr> + </tbody> </table> -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.URL.createObjectURL")}}</p> +{{Compat("api.URL.createObjectURL")}} -<h2 id="See_also">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/API/File/Using_files_from_web_applications">Utiliser des fichiers à partir d’applications web</a></li> - <li><a href="/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images">Utilisation de l’objet URLs pour afficher des images</a></li> - <li>{{domxref("URL.revokeObjectURL()")}}</li> - <li>{{domxref("HTMLMediaElement.srcObject")}}</li> - <li>{{domxref("FileReader.readAsDataURL()")}}</li> -</ul> +- [Utiliser des fichiers à partir d’applications web](/fr/docs/Web/API/File/Using_files_from_web_applications) +- [Utilisation de l’objet URLs pour afficher des images](/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images) +- {{domxref("URL.revokeObjectURL()")}} +- {{domxref("HTMLMediaElement.srcObject")}} +- {{domxref("FileReader.readAsDataURL()")}} diff --git a/files/fr/web/api/url/hash/index.md b/files/fr/web/api/url/hash/index.md index f89d838eb1..9858af61aa 100644 --- a/files/fr/web/api/url/hash/index.md +++ b/files/fr/web/api/url/hash/index.md @@ -9,54 +9,40 @@ tags: - URL translation_of: Web/API/URL/hash --- -<div>{{ APIRef("URL API") }}</div> +{{ APIRef("URL API") }} -<p>La propriété <strong><code>hash</code></strong> de l'interface {{domxref("URL")}} retourne un {{domxref("USVString")}} contenant le caractère <code>'#'</code> suivi par l'identificateur de fragment de URL.</p> +La propriété **`hash`** de l'interface {{domxref("URL")}} retourne un {{domxref("USVString")}} contenant le caractère `'#'` suivi par l'identificateur de fragment de URL. -<p>Le fragment n'est pas <a href="/en-US/docs/Glossary/percent-encoding">décodé en pourcent</a>. Si l'URL ne contient pas d'identificateur de fragment, la valeur de cette propriété est une chaîne de caractère vide — <code>""</code>.</p> +Le fragment n'est pas [décodé en pourcent](/en-US/docs/Glossary/percent-encoding). Si l'URL ne contient pas d'identificateur de fragment, la valeur de cette propriété est une chaîne de caractère vide — `""`. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>string</em> = <em>object</em>.hash; -<em>object</em>.hash = <em>string</em>; -</pre> + string = object.hash; + object.hash = string; -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un {{domxref("USVString")}}.</p> +Un {{domxref("USVString")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: html">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href#Examples'); -url.hash // Returns '#Examples'</pre> +```html +var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href#Examples'); +url.hash // Returns '#Examples' +``` -<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">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('URL', '#dom-url-hash', 'URL.hash')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------- | -------------------- | ------------------- | +| {{SpecName('URL', '#dom-url-hash', 'URL.hash')}} | {{Spec2('URL')}} | Définition initiale | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.URL.hash")}} +## A voir également -<p>{{Compat("api.URL.hash")}}</p> - -<h2 id="A_voir_également">A voir également</h2> - -<ul> - <li>L'interface {{domxref("URL")}} dont il est contenu.</li> -</ul> +- L'interface {{domxref("URL")}} dont il est contenu. 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")}}. diff --git a/files/fr/web/api/url/protocol/index.md b/files/fr/web/api/url/protocol/index.md index a67e867df9..2bc51d5bdc 100644 --- a/files/fr/web/api/url/protocol/index.md +++ b/files/fr/web/api/url/protocol/index.md @@ -9,53 +9,38 @@ tags: - protocole translation_of: Web/API/URL/protocol --- -<div>{{ApiRef("URL API")}}</div> +{{ApiRef("URL API")}} -<p>La propriété <strong><code>protocol</code></strong> de l'interface {{domxref("URL")}} est une {{domxref("USVString")}} représentant le schéma protocolaire de URL, incluant <code>':'</code> à la fin.</p> +La propriété **`protocol`** de l'interface {{domxref("URL")}} est une {{domxref("USVString")}} représentant le schéma protocolaire de URL, incluant `':'` à la fin. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>string</em> = <em>object</em>.protocol; -<em>object</em>.protocol = <em>string</em>; -</pre> + string = object.protocol; + object.protocol = string; -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un {{domxref("USVString")}}.</p> +Un {{domxref("USVString")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/protocol'); +```js +var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/protocol'); var result = url.protocol; // Retourne:"https:" -</pre> +``` -<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">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('URL', '#dom-url-protocol', 'protocol')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-protocol', 'protocol')}} | {{Spec2('URL')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.URL.protocol")}} +## A voir également -<p>{{Compat("api.URL.protocol")}}</p> - -<h2 id="A_voir_également">A voir également</h2> - -<ul> - <li>L'interface {{domxref("URL")}} dont il est contenu.</li> -</ul> +- L'interface {{domxref("URL")}} dont il est contenu. diff --git a/files/fr/web/api/url/revokeobjecturl/index.md b/files/fr/web/api/url/revokeobjecturl/index.md index 5785e39c30..e5cdf42011 100644 --- a/files/fr/web/api/url/revokeobjecturl/index.md +++ b/files/fr/web/api/url/revokeobjecturl/index.md @@ -3,60 +3,41 @@ title: URL.revokeObjectURL() slug: Web/API/URL/revokeObjectURL translation_of: Web/API/URL/revokeObjectURL --- -<div>{{ApiRef("URL")}}</div> +{{ApiRef("URL")}} -<p>La méthode statique <strong><code>URL.revokeObjectURL()</code></strong> libère une URL d’objet existante précédemment créée par un appel à {{domxref("URL.createObjectURL()") }}. Appelez cette méthode quand vous n’utilisez plus une URL d’objet pour indiquer au navigateur qu’il ne doit plus garder de référence sur l’objet.</p> +La méthode statique **`URL.revokeObjectURL()`** libère une URL d’objet existante précédemment créée par un appel à {{domxref("URL.createObjectURL()") }}. Appelez cette méthode quand vous n’utilisez plus une URL d’objet pour indiquer au navigateur qu’il ne doit plus garder de référence sur l’objet. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>window</em>.URL.revokeObjectURL(<em>objectURL</em>); -</pre> + window.URL.revokeObjectURL(objectURL); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>objectURL </code></dt> - <dd>Une {{domxref("DOMString")}} représentant une URL d’objet qui a été précédemment créée par un appel à {{domxref("URL.createObjectURL", "createObjectURL()") }}.</dd> -</dl> +- `objectURL` + - : Une {{domxref("DOMString")}} représentant une URL d’objet qui a été précédemment créée par un appel à {{domxref("URL.createObjectURL", "createObjectURL()") }}. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p><code>undefined</code>.</p> +`undefined`. -<ul> -</ul> +## Exemple -<h2 id="Exemple">Exemple</h2> +Voir [Utilisation de l’objet URLs pour afficher des images](/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images). -<p>Voir <a href="/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images">Utilisation de l’objet URLs pour afficher des images</a>.</p> +## Spécification -<h2 id="Spécification">Spécification</h2> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | ---------------------------- | ------------------- | +| {{SpecName('File API', '#dfn-revokeObjectURL', 'revokeObjectURL()')}} | {{Spec2('File API')}} | Définition initiale | -<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', '#dfn-revokeObjectURL', 'revokeObjectURL()')}}</td> - <td>{{Spec2('File API')}}</td> - <td>Définition initiale</td> - </tr> - </tbody> -</table> +## Compatibilité des navigateurs -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +{{Compat("api.URL.revokeObjectURL")}} -<p>{{Compat("api.URL.revokeObjectURL")}}</p> +## Voir aussi -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/API/File/Using_files_from_web_applications">Utiliser des fichiers à partir d’applications web</a></li> - <li><a href="/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images">Utilisation de l’objet URLs pour afficher des images</a></li> - <li>{{domxref("URL.createObjectURL()") }}</li> -</ul> +- [Utiliser des fichiers à partir d’applications web](/fr/docs/Web/API/File/Using_files_from_web_applications) +- [Utilisation de l’objet URLs pour afficher des images](/fr/docs/Web/API/File/Using_files_from_web_applications#Exemple_Utilisation_de_l'objet_URLs_pour_afficher_des_images) +- {{domxref("URL.createObjectURL()") }} diff --git a/files/fr/web/api/url/search/index.md b/files/fr/web/api/url/search/index.md index eb0a49d3a4..87b1925270 100644 --- a/files/fr/web/api/url/search/index.md +++ b/files/fr/web/api/url/search/index.md @@ -9,53 +9,40 @@ tags: - URL translation_of: Web/API/URL/search --- -<div>{{ApiRef("URL API")}}</div> +{{ApiRef("URL API")}} -<p>La propriété <strong><code>search</code></strong> de l'interface {{domxref("URL")}} est une chaine d'interrogation, aussi appellée une chaine de recherche, c'est un {{domxref("USVString")}} contenant le caractère <code>'?'</code> suivi des paramètres de l'URL.</p> +La propriété **`search`** de l'interface {{domxref("URL")}} est une chaine d'interrogation, aussi appellée une chaine de recherche, c'est un {{domxref("USVString")}} contenant le caractère `'?'` suivi des paramètres de l'URL. -<p>Les navigateurs récents fournissent la propriété {{domxref("URL.searchParams")}} qui permet d'analyser plus facilement les paramètres passés à la chaîne de recherche.</p> +Les navigateurs récents fournissent la propriété {{domxref("URL.searchParams")}} qui permet d'analyser plus facilement les paramètres passés à la chaîne de recherche. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>chaineDeCaractere</em> = <em>objet</em>.search; -<em>object</em>.search = <em>chaineDeCaractere</em>; -</pre> + chaineDeCaractere = objet.search; + object.search = chaineDeCaractere; -<h3 id="Valeur">Valeur</h3> +### Valeur -<p>Un {{domxref("USVString")}}.</p> +Un {{domxref("USVString")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/search?q=123'); +```js +var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/search?q=123'); var queryString = url.search; // Retourne:"?q=123" -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('URL', '#dom-url-search', 'URL.search')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.URL.search")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface {{domxref("URL")}} associée.</li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaire | +| -------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-search', 'URL.search')}} | {{Spec2('URL')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.URL.search")}} + +## Voir aussi + +- L'interface {{domxref("URL")}} associée. diff --git a/files/fr/web/api/url/searchparams/index.md b/files/fr/web/api/url/searchparams/index.md index 9fab62581f..66cc2a85bf 100644 --- a/files/fr/web/api/url/searchparams/index.md +++ b/files/fr/web/api/url/searchparams/index.md @@ -10,56 +10,35 @@ tags: - URLSearchParameters translation_of: Web/API/URL/searchParams --- -<div>{{APIRef("URL API")}}</div> +{{APIRef("URL API")}} La propriété en lecture seule **`searchParams`** de l'interface {{domxref("URL")}} retourneun objet {{domxref("URLSearchParams")}} permettant d'accéder aux arguments décodésde la requête GET contenu dans l'URL. -<div> </div> +{{AvailableInWorkers}} -<div>La propriété en lecture seule <strong><code>searchParams</code></strong> de l'interface {{domxref("URL")}} retourne</div> +## Syntaxe -<div>un objet {{domxref("URLSearchParams")}} permettant d'accéder aux arguments décodés</div> + var urlSearchParams = URL.searchParams; -<div>de la requête GET contenu dans l'URL.</div> +### Value -<div> </div> +Un objet {{domxref("URLSearchParams")}}. -<p>{{AvailableInWorkers}}</p> +## Exemples -<h2 id="Syntaxe">Syntaxe</h2> +Si l'URL de votre page est `https://example.com/?nom=Jonathan%20Smith&age=18` +vous pouvez extraire les paramètres 'nom' et 'age' en utilisant: -<pre class="syntaxbox">var urlSearchParams = URL.searchParams;</pre> - -<h3 id="Value">Value</h3> - -<p>Un objet {{domxref("URLSearchParams")}}.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Si l'URL de votre page est <code>https://example.com/?nom=Jonathan%20Smith&age=18</code><br> - vous pouvez extraire les paramètres 'nom' et 'age' en utilisant:</p> - -<pre class="brush: js">let params = (new URL(document.location)).searchParams; +```js +let params = (new URL(document.location)).searchParams; let name = params.get('nom'); // la chaine de caractère "Jonathan Smith". -let age = parseInt(params.get('age')); // le nombre 18</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">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('URL', '#dom-url-searchparams', 'searchParams')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +let age = parseInt(params.get('age')); // le nombre 18 +``` -<h2 id="Compatibilités_des_navigateurs">Compatibilités des navigateurs</h2> +## Spécifications +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-searchparams', 'searchParams')}} | {{Spec2('URL')}} | Définition initiale. | +## Compatibilités des navigateurs -<p>{{Compat("api.URL.searchParams")}}</p> +{{Compat("api.URL.searchParams")}} diff --git a/files/fr/web/api/url/tojson/index.md b/files/fr/web/api/url/tojson/index.md index 3b594c32cd..4c53981f11 100644 --- a/files/fr/web/api/url/tojson/index.md +++ b/files/fr/web/api/url/tojson/index.md @@ -9,49 +9,35 @@ tags: - toJSON() translation_of: Web/API/URL/toJSON --- -<div>{{APIRef("URL API")}}</div> +{{APIRef("URL API")}} -<p>La méthode <strong><code>toJSON()</code></strong> de l'interface {{domxref("URL")}} retourne un {{domxref("USVString")}} contenant une version sérialisé de l'URL, même si dans la pratique, il semble avoir le même effet que {{domxref("URL.toString()")}}.</p> +La méthode **`toJSON()`** de l'interface {{domxref("URL")}} retourne un {{domxref("USVString")}} contenant une version sérialisé de l'URL, même si dans la pratique, il semble avoir le même effet que {{domxref("URL.toString()")}}. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntax">Syntax</h2> +## Syntax -<pre class="syntaxbox">json = url.toJSON();</pre> + json = url.toJSON(); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Aucun.</p> +Aucun. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>A {{domxref("USVString")}}.</p> +A {{domxref("USVString")}}. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre>const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"); -url.toJSON() -</pre> + const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"); + url.toJSON() -<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">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('URL', '#dom-url-tojson', 'toJSON()')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-tojson', 'toJSON()')}} | {{Spec2('URL')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs - - -<p>{{Compat("api.URL.toJSON")}}</p> +{{Compat("api.URL.toJSON")}} diff --git a/files/fr/web/api/url/tostring/index.md b/files/fr/web/api/url/tostring/index.md index f3733e2678..5f61fd9b31 100644 --- a/files/fr/web/api/url/tostring/index.md +++ b/files/fr/web/api/url/tostring/index.md @@ -9,53 +9,41 @@ tags: - toString() translation_of: Web/API/URL/toString --- -<div>{{ApiRef("URL API")}}</div> +{{ApiRef("URL API")}} -<p>La méthode <strong><code>URL.toString()</code></strong> retourne un {{domxref("USVString")}} contenant tout l'URL. C'est en effet, une version de {{domxref("URL.href")}} en lecture seule.</p> +La méthode **`URL.toString()`** retourne un {{domxref("USVString")}} contenant tout l'URL. C'est en effet, une version de {{domxref("URL.href")}} en lecture seule. -<p>{{AvailableInWorkers}}</p> +{{AvailableInWorkers}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>string</em> = <em>url</em>.toString();</pre> + string = url.toString(); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>Aucun.</p> +Aucun. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un {{domxref("USVString")}}.</p> +Un {{domxref("USVString")}}. -<h2 id="Examples">Examples</h2> +## Examples -<pre class="brush: js">const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"); +```js +const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"); url.toString() // doit retourner l'URL en tant que chaîne -</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">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('URL', '#URL-stringification-behavior', 'stringifier')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.URL.toString")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface {{domxref("URL")}} à laquelle elle appartient.</li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#URL-stringification-behavior', 'stringifier')}} | {{Spec2('URL')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.URL.toString")}} + +## Voir aussi + +- L'interface {{domxref("URL")}} à laquelle elle appartient. diff --git a/files/fr/web/api/url/url/index.md b/files/fr/web/api/url/url/index.md index c0ff1cb049..cb9012b467 100644 --- a/files/fr/web/api/url/url/index.md +++ b/files/fr/web/api/url/url/index.md @@ -9,52 +9,37 @@ tags: - URL API translation_of: Web/API/URL/URL --- -<p>{{APIRef("URL API")}}</p> +{{APIRef("URL API")}} -<p>Le constructeur <strong><code>URL()</code></strong> renvoie un nouvel objet {{domxref("URL")}} représentant l'URL définie par les paramètres.<br> - <br> - Si l'URL de base donnée ou l'URL résultante ne sont pas des URL valides, une {{domxref("DOMException")}} de type <code>SYNTAX_ERROR</code> est levée.</p> +Le constructeur **`URL()`** renvoie un nouvel objet {{domxref("URL")}} représentant l'URL définie par les paramètres. -<p>{{AvailableInWorkers}}</p> +Si l'URL de base donnée ou l'URL résultante ne sont pas des URL valides, une {{domxref("DOMException")}} de type `SYNTAX_ERROR` est levée. -<h2 id="Syntax">Syntax</h2> +{{AvailableInWorkers}} -<pre class="syntaxbox"><em>url</em> = new URL(<em>url</em>, [<em>base</em>]) -</pre> +## Syntax -<h3 id="Paramètres">Paramètres</h3> + url = new URL(url, [base]) -<dl> - <dt><em>url</em></dt> - <dd>Un {{domxref("USVString")}} représentant une URL absolue ou relative. Si l'URL est une URL relative, la base est obligatoire et sera utilisée comme URL de base. Si url est une URL absolue, une base donnée sera ignorée.</dd> - <dt><em>base </em>{{optional_inline}}</dt> - <dd>Un {{domxref("USVString")}} représentant l'URL de base à utiliser dans le cas où l'URL est une URL relative. Si non spécifié, il est par défaut à <code>''</code>.</dd> -</dl> +### Paramètres -<div class="note"> -<p><strong>Note :</strong> Vous pouvez toujours utiliser un objet {{domxref ("URL")}} existant pour la base, qui se stringifie en attribut {{domxref ("DOMString.href", "href")}} de l'objet.</p> -</div> +- _url_ + - : Un {{domxref("USVString")}} représentant une URL absolue ou relative. Si l'URL est une URL relative, la base est obligatoire et sera utilisée comme URL de base. Si url est une URL absolue, une base donnée sera ignorée. +- _base_ {{optional_inline}} + - : Un {{domxref("USVString")}} représentant l'URL de base à utiliser dans le cas où l'URL est une URL relative. Si non spécifié, il est par défaut à `''`. -<h3 id="Exceptions">Exceptions</h3> +> **Note :** Vous pouvez toujours utiliser un objet {{domxref ("URL")}} existant pour la base, qui se stringifie en attribut {{domxref ("DOMString.href", "href")}} de l'objet. -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Exception</th> - <th scope="col">Explication</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>TypeError</code></td> - <td>url (dans le cas d'URL absolues) ou base + URL (dans le cas d'URL relatives) n'est pas une URL valide.</td> - </tr> - </tbody> -</table> +### Exceptions -<h2 id="Exemple">Exemple</h2> +| Exception | Explication | +| ----------- | ------------------------------------------------------------------------------------------------------ | +| `TypeError` | url (dans le cas d'URL absolues) ou base + URL (dans le cas d'URL relatives) n'est pas une URL valide. | -<pre class="brush: js">var a = new URL("/", "https://developer.mozilla.org"); // Crée une URL pointant vers 'https://developer.mozilla.org/' +## Exemple + +```js +var a = new URL("/", "https://developer.mozilla.org"); // Crée une URL pointant vers 'https://developer.mozilla.org/' var b = new URL("https://developer.mozilla.org"); // Crée une URL pointant vers 'https://developer.mozilla.org/' var c = new URL('en-US/docs', b); // Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs' var d = new URL('/en-US/docs', b); // Crée une URL pointant vers 'https://developer.mozilla.org/en-US/docs' @@ -67,31 +52,18 @@ var j = new URL('/en-US/docs'); // Déclenche une excepti var k = new URL('http://www.example.com', 'https://developers.mozilla.com'); // Crée une URL pointant vers 'http://www.example.com/' var l = new URL('http://www.example.com', b); // Crée une URL pointant vers 'http://www.example.com/' -</pre> - -<h2 id="Specification">Spécification</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('URL', '#constructors', 'URL.URL()')}}</td> - <td>{{Spec2('URL')}}</td> - <td>initialisation.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.URL.URL")}}</p> - -<h2 id="À_voir_également">À voir également</h2> - -<ul> - <li>L'interface à laquelle il appartient : {{domxref("URL")}}.</li> -</ul> +``` + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------- | -------------------- | --------------- | +| {{SpecName('URL', '#constructors', 'URL.URL()')}} | {{Spec2('URL')}} | initialisation. | + +## Compatibilité des navigateurs + +{{Compat("api.URL.URL")}} + +## À voir également + +- L'interface à laquelle il appartient : {{domxref("URL")}}. |