Méthode JSON stringify() en JavaScript

Définition et utilisation

La méthode JSON.stringify() convertit un objet JavaScript en chaîne de caractères.

Lorsque des données sont envoyées à un serveur Web, elles doivent être au format chaîne de caractères.

Exemple

Exemple 1

Sérialiser un objet JavaScript en chaîne :

var obj = { "name":"Bill", "age":19, "city":"Seattle"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

Essayez-le vous-même

Exemple 2

Utilisez une fonction de remplacement :

/* Remplacer la valeur de "city" en majuscules :*/
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, function (key, value) {
  if (key == "city") {
    return value.toUpperCase();
  } else {
    return value;
  }
});

Essayez-le vous-même

Exemple 3

Utilisation espace Paramètres :

/* Insérer 10 espaces pour chaque espace :*/
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, null, 10);

Essayez-le vous-même

Exemple 4

Utilisation espace Paramètres :

/* Insérer le mot SPACE pour chaque espace :*/
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, null, "SPACE");

Essayez-le vous-même

Syntaxe

JSON.stringify(obj, replacer, espace)

Valeur du paramètre

Paramètre Description
obj Obligatoire. Valeur à convertir en chaîne.
replacer

Optionnel. Fonction ou tableau utilisé pour convertir le résultat.

Si le paramètre est une fonction, chaque propriété de la valeur sérialisée passera par le traitement et la conversion de cette fonction pendant le processus de sérialisation ;

Si le paramètre est un tableau, seules les noms de propriétés contenus dans ce tableau seront sérialisées dans la chaîne JSON finale ;

Si ce paramètre est null ou non fourni, toutes les propriétés de l'objet seront sérialisées.
espace

Optionnel. Chaîne ou valeur numérique. Spécifiez une chaîne d'espaces blanches pour l'indentation, ce qui améliore l'affichage (pretty-print).

Si le paramètre est un nombre, il représente combien d'espaces ; le maximum est de 10. Cette valeur si elle est inférieure à 1 signifie qu'il n'y aura pas d'espaces ;

Si ce paramètre est une chaîne (lorsque la longueur de la chaîne dépasse 10 lettres, prenez les 10 premières lettres), cette chaîne sera traitée comme une espace ;

Si ce paramètre n'est pas fourni (ou est null), il n'y aura pas d'espaces.

Détails techniques

Valeur de retour : Une chaîne
Version de JavaScript : ECMAScript 5

Support du navigateur

Les nombres dans le tableau indiquent la version du navigateur la première à prendre en charge cette méthode.

Méthode Chrome IE Firefox Safari Opera
stringify() 4.0 8.0 3.5 4.0 11.5

Pages associées

Tutoriel JSON :Introduction à JSON