Manual de Referência JSON JavaScript

JSON (JavaScript Object Notation, JavaScript Notação de Objetos)

JSON é um formato usado para armazenar e transmitir dados.

JSON é texto, que pode ser transmitido em qualquer lugar e lido por qualquer linguagem de programação.

JavaScript objeto pode ser convertido para JSON, JSON pode ser convertido de volta para objeto JavaScript.

Dessa forma, podemos usar os dados como objeto JavaScript, sem a necessidade de parsing ou conversão complexos.

Exemplo

Enviar JSON:

// Objeto JavaScript...
var myObj = { "name":"Bill", "age":19, "city":"Seattle" };
// ...Converter para JSON:
var myJSON = JSON.stringify(myObj);
// Enviar JSON:
window.location = "demo_json.php?x=" + myJSON;

Experimente pessoalmente

Para mais informações sobre JSON, leia nosso Tutorial de JSON.

Métodos JSON

Método Descrição
parse() 解析 string JSON e retornar objeto JavaScript.
stringify() Converter objeto JavaScript para string JSON.

Tipos de dados válidos

No JSON, os valores devem ser do tipo de dados seguinte:

  • String
  • Número
  • Objeto (contendo valores JSON válidos)
  • Array
  • Booleano
  • null

Os valores JSON não podem ser do tipo de dados seguinte:

  • Função
  • Data
  • undefined

Mais exemplos

Exemplo

Receber JSON:

// myJSON é o texto recebido no formato JSON
// Converter JSON para objeto JavaScript:
var myObj = JSON.parse(myJSON);
document.getElementById("demo").innerHTML = myObj.name;

Experimente pessoalmente

Exemplo

Usar localStorage para armazenar dados como JSON:

// Armazenar dados:
myObj = { "name":"Bill", "age":19, "city":"Seattle" };
myJSON = JSON.stringify(myObj);
localStorage.setItem("testJSON", myJSON);
// Recuperar dados:
text = localStorage.getItem("testJSON");
obj = JSON.parse(text);
document.getElementById("demo").innerHTML = obj.name;

Experimente pessoalmente

Para mais informações sobre JSON, leia nosso Tutorial de JSON.