blob: 818de7759569f2afd7c16fc67a217029e939b949 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
---
title: decodeURI()
slug: Web/JavaScript/Reference/Global_Objects/decodeURI
tags:
- JavaScript
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/decodeURI
original_slug: Web/JavaScript/Reference/Objets_globaux/decodeURI
---
{{jsSidebar("Objects")}}
La méthode **`decodeURI()`** permet de décoder un Uniform Resource Identifier (URI) créé par la méthode {{jsxref("encodeURI","encodeURI()")}} ou une méthode similaire.
{{EmbedInteractiveExample("pages/js/globalprops-decodeuri.html")}}
## Syntaxe
decodeURI(encodedURI)
### Paramètres
- `encodedURI`
- : Un URI complet, encodé.
### Valeur de retour
Une nouvelle chaîne de caractères dont certains caractères ont été décodés à partir de l'URI encodée passée en argument.
### Exceptions
Cette méthode lève une exception {{jsxref("URIError")}} ("_malformed URI sequence"_) lorsque la chaîne passée en argument contient des séquences de caractères invalides.
## Description
Cette méthode remplace chaque séquence d'échappement présente dans l'URI encodée avec le caractère correspondant. Les séquences d'échappement qui n'auraient pas pu être introduites par {{jsxref("encodeURI", "encodeURI()")}} ne seront pas décodées. Le caractère « `#` » n'est pas décodé au sein des séquences d'échappement.
## Exemples
### Décoder une URL cyrillique
```js
decodeURI("https://developer.mozilla.org/ru/docs/JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B");
// "https://developer.mozilla.org/ru/docs/JavaScript_шеллы"
```
### Gérer les exceptions
```js
try {
var a = decodeURI('%E0%A4%A');
} catch(e) {
console.error(e);
}
// Cela produira "URIError: malformed URI sequence"
```
## Spécifications
| Spécification | État | Commentaires |
| ---------------------------------------------------------------------------------------- | ---------------------------- | -------------------- |
| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. |
| {{SpecName('ES5.1', '#sec-15.1.3.1', 'decodeURI')}} | {{Spec2('ES5.1')}} | |
| {{SpecName('ES6', '#sec-decodeuri-encodeduri', 'decodeURI')}} | {{Spec2('ES6')}} | |
| {{SpecName('ESDraft', '#sec-decodeuri-encodeduri', 'decodeURI')}} | {{Spec2('ESDraft')}} | |
## Compatibilité des navigateurs
{{Compat("javascript.builtins.decodeURI")}}
## Voir aussi
- {{jsxref("decodeURIComponent","decodeURIComponent()")}}
- {{jsxref("encodeURI","encodeURI()")}}
- {{jsxref("encodeURIComponent","encodeURIComponent()")}}
|
