getJSON |
jQuery |
|---|---|
| JavaScript | Version 1.0+ |
Syntaxe
| jQuery.getJSON( url [, data] [, success(data, textStatus, jqXHR)] ) | 1.0+ |
Paramètres
| Nom | Description | |
|---|---|---|
| url | Ce paramètre permet d'indiquer une chaine de caractères contenant l'URL dans lequel la requête est envoyé. | |
| data | Ce paramètre permet d'indiquer un objet plein ou une chaine de caractères étant envoyé au serveur avec la requête. | |
| success(data, textStatus, jqXHR) | Ce paramètre permet d'indiquer une fonction a appeler lorsque la requête à été exécuté avec succès. Le sous-paramètre permet d'indiquer une méthode et propriété d'objet «jqXHR» : | |
| Méthode | Description | |
| abort() | Cette méthode permet d'annuler la requête d'exécution courante. | |
| getAllResponseHeaders() | Cette méthode permet de demander une chaine de caractères contenant les noms et la valeur de tous les réponses d'entêtes. | |
| getResponseHeader(name) | Cette méthode permet de demander la valeur des entêtes de réponses spécifiés. | |
| setRequestHeader(name, value) | Cette méthode permet de fixer l'entête de requête utiliser avec le nom et la valeur spécifié. | |
| Propriété | Description | |
| readyState | Cette propriété permet d'indiquer l'état de la requête. | |
| responseText | Cette propriété permet d'indiquer la réponse de requête sous-jacente avec un texte. | |
| responseXML | Cette propriété permet d'indiquer la réponse de requête sous-jacente avec du XML. | |
| status | Cette propriété permet d'indiquer le code de réponse retourné par le serveur. | |
| statusText | Cette propriété d'indiquer l'état du message de texte renvoyés par le réponse. | |
Description
Cette méthode permet de charger des données JSON encodés sur le serveur en utilisant une requête GET de HTTP, et l'exécute.
Remarques
- Le navigateur Web utilise la même politique d'origine en JavaScript qu'avec le HTML (aussi connu sous le nom de «cross-domain»), et donc une demande ne peut récupérer les données d'un autre domaine, sous-domaine ou protocole sans que le serveur envoi un code d'entête «Access-Control-Allow-Origin:» approprié. Exemple en PHP : «header('Access-Control-Allow-Origin':'*');».
- La méthode «jQuery.getJSON()» renvoi un objet jqXHR lequel est en faite un sous-objet de «XMLHttpRequest».
Voir également
Référence des formats de données - JSON
Dernière mise à jour : Vendredi, le 30 octobre 2015