From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/url/createobjecturl/index.md | 117 ++++++------- files/fr/web/api/url/hash/index.md | 58 +++---- files/fr/web/api/url/index.md | 241 ++++++++++++-------------- files/fr/web/api/url/protocol/index.md | 55 +++--- files/fr/web/api/url/revokeobjecturl/index.md | 63 +++---- files/fr/web/api/url/search/index.md | 67 +++---- files/fr/web/api/url/searchparams/index.md | 59 ++----- files/fr/web/api/url/tojson/index.md | 50 ++---- files/fr/web/api/url/tostring/index.md | 66 +++---- files/fr/web/api/url/url/index.md | 98 ++++------- 10 files changed, 360 insertions(+), 514 deletions(-) (limited to 'files/fr/web/api/url') 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é. -

{{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é.

+Pour libérer une URL d’objet, il faut appeler {{domxref("URL.revokeObjectURL", "revokeObjectURL()")}} -

Pour libérer une URL d’objet, il faut appeler {{domxref("URL.revokeObjectURL", "revokeObjectURL()")}}

+{{AvailableInWorkers}} -

{{AvailableInWorkers}}

+> **Note :** Cette fonctionnalité n'est pas disponible dans les [Service Workers](/fr/docs/Web/API/ServiceWorker) à cause de possible fuite mémoire. -
-

Note : Cette fonctionnalité n'est pas disponible dans les Service Workers à cause de possible fuite mémoire.

-
+## Syntaxe -

Syntaxe

+ objectURL = URL.createObjectURL(object); -
objectURL = URL.createObjectURL(object);
-
+### Paramètres -

Paramètres

+- `object` + - : Un objet {{domxref("File")}}, {{domxref("Blob")}} ou {{domxref("MediaSource")}} pour lequel créer une URL d’objet. -
-
object
-
Un objet {{domxref("File")}}, {{domxref("Blob")}} ou {{domxref("MediaSource")}} pour lequel créer une URL d’objet.
-
+### Valeur de retour -

Valeur de retour

+Une {{domxref("DOMString")}} contenant une URL d’objet, pouvant être utilisée comme une référence vers l’objet source `object` spécifié. -

Une {{domxref("DOMString")}} contenant une URL d’objet, pouvant être utilisée comme une référence vers l’objet source object spécifié.

+## Exemple -

Exemple

+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). -

Voir Utilisation de l’objet URLs pour afficher des images.

+## Notes d’utilisation -

Notes d’utilisation

+### Gestion de la mémoire -

Gestion de la mémoire

+À 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. -

À 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.

+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. -

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.

+### Utiliser les URL d’objet pour les flux de média -

Utiliser les URL d’objet pour les flux de média

+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. -

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.

+> **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`. -
-

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.

-
- -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("File API", "#dfn-createObjectURL", "createObjectURL()")}}{{Spec2("File API")}}Définition initiale.
{{SpecName("Media Source Extensions", "#dom-url-createobjecturl", "URL")}}{{Spec2("Media Source Extensions")}} -

Extension MediaSource.
- Les anciennes versions de cette spécification utilisaient createObjectURL() pour les objets {{domxref("MediaStream")}} ; ce n’est plus supporté.

-
SpécificationStatutCommentaire
+ {{SpecName("File API", "#dfn-createObjectURL", "createObjectURL()")}} + {{Spec2("File API")}}Définition initiale.
+ {{SpecName("Media Source Extensions", "#dom-url-createobjecturl", "URL")}} + {{Spec2("Media Source Extensions")}} +

+ Extension MediaSource.
Les anciennes versions de cette + spécification utilisaient createObjectURL() pour les + objets {{domxref("MediaStream")}} ; ce n’est plus supporté. +

+
-

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.URL.createObjectURL")}}

+{{Compat("api.URL.createObjectURL")}} -

Voir aussi

+## Voir aussi - +- [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 --- -
{{ APIRef("URL API") }}
+{{ APIRef("URL API") }} -

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.

+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. -

Le fragment n'est pas décodé en pourcent. Si l'URL ne contient pas d'identificateur de fragment, la valeur de cette propriété est une chaîne de caractère vide — "".

+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 — `""`. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
string = object.hash;
-object.hash = string;
-
+ string = object.hash; + object.hash = string; -

Valeur

+### Valeur -

Un {{domxref("USVString")}}.

+Un {{domxref("USVString")}}. -

Exemples

+## Exemples -
var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href#Examples');
-url.hash // Returns '#Examples'
+```html +var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href#Examples'); +url.hash // Returns '#Examples' +``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('URL', '#dom-url-hash', 'URL.hash')}}{{Spec2('URL')}}Définition initiale
+| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------- | -------------------- | ------------------- | +| {{SpecName('URL', '#dom-url-hash', 'URL.hash')}} | {{Spec2('URL')}} | Définition initiale | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs +{{Compat("api.URL.hash")}} +## A voir également -

{{Compat("api.URL.hash")}}

- -

A voir également

- - +- 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 --- -
{{ApiRef("URL API")}}
+{{ApiRef("URL API")}} -

L'interface URL représente un objet qui fournit des méthodes statiques utilisées pour créer des URL d'objet.

+L'interface **`URL`\*\*** \*\*représente un objet qui fournit des méthodes statiques utilisées pour créer des URL d'objet. -

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).

+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`). -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Utilisation

+## Utilisation -

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 :

+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 : -
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"
+console.log(url.pathname); // "/cats" +``` -

Les propriétés de l'URL peuvent être définies pour construire l'URL :

+Les propriétés de l'URL peuvent être définies pour construire l'URL : -
url.hash = 'tabby';
-console.log(url.href); // "http://www.example.com/cats#tabby"
+```js +url.hash = 'tabby'; +console.log(url.href); // "http://www.example.com/cats#tabby" +``` -

Les URL seront encodées selon la norme RFC 3986:

+Les URL seront encodées selon la norme RFC 3986: -
url.pathname = 'démonstration.html';
-console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html"
+```js +url.pathname = 'démonstration.html'; +console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html" +``` -

L'interface {{domxref("URLSearchParams")}}  peut être utilisée pour construire et manipuler la chaîne de requête de l'URL.

+L'interface {{domxref("URLSearchParams")}}  peut être utilisée pour construire et manipuler la chaîne de requête de l'URL. -

Pour obtenir les paramètres de recherche à partir de l'URL de la fenêtre en cours :

+Pour obtenir les paramètres de recherche à partir de l'URL de la fenêtre en cours : -
// 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
- -

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 :

- -
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écificationStatutCommentaire
{{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

- - +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 --- -
{{ApiRef("URL API")}}
+{{ApiRef("URL API")}} -

La propriété protocol de l'interface {{domxref("URL")}} est une {{domxref("USVString")}} représentant le schéma protocolaire de URL, incluant ':' à la fin.

+La propriété **`protocol`** de l'interface {{domxref("URL")}} est une {{domxref("USVString")}} représentant le schéma protocolaire de URL, incluant `':'` à la fin. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
string = object.protocol;
-object.protocol = string;
-
+ string = object.protocol; + object.protocol = string; -

Valeur

+### Valeur -

Un {{domxref("USVString")}}.

+Un {{domxref("USVString")}}. -

Exemples

+## Exemples -
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:"
-
+``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('URL', '#dom-url-protocol', 'protocol')}}{{Spec2('URL')}}Définition initiale.
+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-protocol', 'protocol')}} | {{Spec2('URL')}} | Définition initiale. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs +{{Compat("api.URL.protocol")}} +## A voir également -

{{Compat("api.URL.protocol")}}

- -

A voir également

- - +- 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 --- -
{{ApiRef("URL")}}
+{{ApiRef("URL")}} -

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.

+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. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
window.URL.revokeObjectURL(objectURL);
-
+ window.URL.revokeObjectURL(objectURL); -

Paramètres

+### Paramètres -
-
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()") }}.
-
+- `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()") }}. -

Valeur de retour

+### Valeur de retour -

undefined.

+`undefined`. - +## Exemple -

Exemple

+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). -

Voir Utilisation de l’objet URLs pour afficher des images.

+## Spécification -

Spécification

+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | ---------------------------- | ------------------- | +| {{SpecName('File API', '#dfn-revokeObjectURL', 'revokeObjectURL()')}} | {{Spec2('File API')}} | Définition initiale | - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('File API', '#dfn-revokeObjectURL', 'revokeObjectURL()')}}{{Spec2('File API')}}Définition initiale
+## Compatibilité des navigateurs -

Compatibilité des navigateurs

+{{Compat("api.URL.revokeObjectURL")}} -

{{Compat("api.URL.revokeObjectURL")}}

+## Voir aussi -

Voir aussi

- - +- [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 --- -
{{ApiRef("URL API")}}
+{{ApiRef("URL API")}} -

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.

+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. -

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.

+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. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
chaineDeCaractere = objet.search;
-object.search = chaineDeCaractere;
-
+ chaineDeCaractere = objet.search; + object.search = chaineDeCaractere; -

Valeur

+### Valeur -

Un {{domxref("USVString")}}.

+Un {{domxref("USVString")}}. -

Exemples

+## Exemples -
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"
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaire
{{SpecName('URL', '#dom-url-search', 'URL.search')}}{{Spec2('URL')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.URL.search")}}

- -

Voir aussi

- - +``` + +## 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 --- -
{{APIRef("URL API")}}
+{{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. -
 
+{{AvailableInWorkers}} -
La propriété en lecture seule searchParams de l'interface {{domxref("URL")}} retourne
+## Syntaxe -
un objet {{domxref("URLSearchParams")}} permettant d'accéder aux arguments décodés
+ var urlSearchParams = URL.searchParams; -
de la requête GET contenu dans l'URL.
+### Value -
 
+Un objet {{domxref("URLSearchParams")}}. -

{{AvailableInWorkers}}

+## Exemples -

Syntaxe

+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: -
var urlSearchParams = URL.searchParams;
- -

Value

- -

Un objet {{domxref("URLSearchParams")}}.

- -

Exemples

- -

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:

- -
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
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('URL', '#dom-url-searchparams', 'searchParams')}}{{Spec2('URL')}}Définition initiale.
+let age = parseInt(params.get('age')); // le nombre 18 +``` -

Compatibilités des navigateurs

+## Spécifications +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-searchparams', 'searchParams')}} | {{Spec2('URL')}} | Définition initiale. | +## Compatibilités des navigateurs -

{{Compat("api.URL.searchParams")}}

+{{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 --- -
{{APIRef("URL API")}}
+{{APIRef("URL API")}} -

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()")}}.

+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()")}}. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntax

+## Syntax -
json = url.toJSON();
+ json = url.toJSON(); -

Paramètres

+### Paramètres -

Aucun.

+Aucun. -

Valeur retournée

+### Valeur retournée -

A {{domxref("USVString")}}.

+A {{domxref("USVString")}}. -

Exemples

+## Exemples -
const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString");
-url.toJSON()
-
+ const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"); + url.toJSON() -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('URL', '#dom-url-tojson', 'toJSON()')}}{{Spec2('URL')}}Définition initiale.
+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#dom-url-tojson', 'toJSON()')}} | {{Spec2('URL')}} | Définition initiale. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs - - -

{{Compat("api.URL.toJSON")}}

+{{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 --- -
{{ApiRef("URL API")}}
+{{ApiRef("URL API")}} -

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.

+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. -

{{AvailableInWorkers}}

+{{AvailableInWorkers}} -

Syntaxe

+## Syntaxe -
string = url.toString();
+ string = url.toString(); -

Paramètres

+### Paramètres -

Aucun.

+Aucun. -

Valeur de retour

+### Valeur de retour -

Un {{domxref("USVString")}}.

+Un {{domxref("USVString")}}. -

Examples

+## Examples -
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
-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('URL', '#URL-stringification-behavior', 'stringifier')}}{{Spec2('URL')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.URL.toString")}}

- -

Voir aussi

- - +``` + +## 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 --- -

{{APIRef("URL API")}}

+{{APIRef("URL API")}} -

Le constructeur URL() renvoie un nouvel objet {{domxref("URL")}} représentant l'URL définie par les paramètres.
-
- 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.

+Le constructeur **`URL()`** renvoie un nouvel objet {{domxref("URL")}} représentant l'URL définie par les paramètres. -

{{AvailableInWorkers}}

+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. -

Syntax

+{{AvailableInWorkers}} -
url = new URL(url, [base])
-
+## Syntax -

Paramètres

+ url = new URL(url, [base]) -
-
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 à ''.
-
+### Paramètres -
-

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.

-
+- _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 à `''`. -

Exceptions

+> **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. - - - - - - - - - - - - - -
ExceptionExplication
TypeErrorurl (dans le cas d'URL absolues) ou base + URL (dans le cas d'URL relatives) n'est pas une URL valide.
+### Exceptions -

Exemple

+| 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. | -
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/'
-
- -

Spécification

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('URL', '#constructors', 'URL.URL()')}}{{Spec2('URL')}}initialisation.
- -

Compatibilité des navigateurs

- -

{{Compat("api.URL.URL")}}

- -

À voir également

- - +``` + +## 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")}}. -- cgit v1.2.3-54-g00ecf