JavaScript JSON stringify() -menetelmä

Määritelmä ja käyttö

JSON.stringify() -metodi muuntaa JavaScript-objektin merkkijonoksi.

Kun data lähetetään Web-palvelimeen, data on oltava merkkijono.

Esimerkki

Esimerkki 1

JavaScript-objektin merkkijonoituminen:

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

Kokeile itse

Esimerkki 2

Käytä korvausfunktiota:

/* Korvaa "city"-arvo isolla kirjaimella:*/
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;
  }
});

Kokeile itse

Esimerkki 3

Käyttö tyhjät merkit Parametri:

/* Lisää jokaiseen välilyöntiin 10 välilyöntiä:*/
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, null, 10);

Kokeile itse

Esimerkki 4

Käyttö tyhjät merkit Parametri:

/* Lisää jokaiseen välilyöntiin sana SPACE:*/
var obj = { "name":"Bill", "age":"19", "city":"Seattle"};
var text = JSON.stringify(obj, null, "SPACE");

Kokeile itse

Syntaksi

JSON.stringify(obj, korvaaja, tyhjät merkit)

Parametrin arvo

Parametri Kuvaus
obj Välttämätön. Arvo, joka konversoidaan merkkijonoksi.
korvaaja

Valinnainen. Funktio tai taulukko, joka muuntaa tuloksen.

Jos parametri on funktio, jokainen serialisoitava arvon ominaisuus käsitellään ja muunnetaan kyseisen funktion kautta;

Jos parametri on taulukko, vain taulukossa olevat ominaisuuden nimet serialisoidaan lopulliseen JSON-merkkijonoon;

Jos parametri on null tai sitä ei ole annettu, kaikki objektin ominaisuudet serialisoidaan.

tyhjät merkit

Valinnainen. Merkkijono- tai lukuarvo. Määrittää tyhjät merkit, joita käytetään sisennykseen (pretty-print).

Jos parametri on luku, se edustaa kuinka monta välilyöntiä; enimmäismäärä on 10. Jos tämä arvo on alle 1, se tarkoittaa, että välilyöntejä ei ole;

Jos parametri on merkkijono (kun merkkijonon pituus on yli 10 kirjainta, otetaan ensimmäiset 10 kirjainta), merkkijono toimii välilyöntinä;

Jos parametria ei ole annettu (tai se on null), ei ole välilyöntejä.

Tekninen tarkistus

Palautusarvo: A String
JavaScript versioona: ECMAScript 5

Selaimen tuki

Taulukossa olevat numerot osoittavat ensimmäisen selaimen version, joka tukee tätä metodia täysin.

Metodi Chrome IE Firefox Safari Opera
stringify() 4.0 8.0 3.5 4.0 11.5

Aiheeseen liittyvät sivut

JSON opetusohjelma:JSON esittely