Referência JSON JavaScript
JSON ( J ava S cript O bject N otation )
JSON é um formato para armazenar e transportar dados.
JSON é texto, e o texto pode ser transportado para qualquer lugar e lido por qualquer linguagem de programação.
Objetos JavaScript podem ser convertidos em JSON e JSON pode ser convertido novamente em objetos JavaScript.
Dessa forma, podemos trabalhar com os dados como objetos JavaScript, sem análises ou traduções complicadas.
Exemplo
Enviando JSON:
// a JavaScript object...:
var myObj =
{ "name":"John",
"age":31, "city":"New York" };
// ...converted into JSON:
var myJSON =
JSON.stringify(myObj);
// send JSON:
window.location = "demo_json.php?x=" + myJSON;
Para um tutorial sobre JSON, leia nosso Tutorial JSON .
Métodos JSON
Method | Description |
---|---|
parse() | Parses a JSON string and returns a JavaScript object |
stringify() | Convert a JavaScript object to a JSON string |
Tipos de dados válidos
Em JSON, os valores devem ser um dos seguintes tipos de dados:
- uma linha
- um número
- um objeto (contendo valores JSON válidos)
- uma matriz
- um booleano
- nulo
Os valores JSON não podem ser um dos seguintes tipos de dados:
- uma função
- um encontro
- Indefinido
Mais exemplos
Exemplo
Recebendo JSON:
// myJSON is text received in JSON format.
// Convert JSON into a JavaScript
object:
var myObj =
JSON.parse(myJSON);
document.getElementById("demo").innerHTML = myObj.name;
Exemplo
Armazenando dados como JSON, usando localStorage
// Storing data:
myObj =
{ "name":"John",
"age":31, "city":"New York" };
myJSON =
JSON.stringify(myObj);
localStorage.setItem("testJSON", myJSON);
// Retrieving data:
text = localStorage.getItem("testJSON");
obj =
JSON.parse(text);
document.getElementById("demo").innerHTML = obj.name;
Saiba mais sobre JSON em nosso tutorial JSON .