Formatador JSON

Visão Geral do Formato JSON

JSON (JavaScript Object Notation) é um formato leve para intercâmbio de dados. Compreender suas regras é essencial para criar e manipular estruturas de dados JSON de forma eficaz.

Regras Principais

1. Objetos
   • Encapsulados entre { }.
   • Um objeto vazio: { }.
2. Arrays (Vetores)
   • Encapsulados entre [ ].
   • Um array vazio: [ ].
3. Membros (Pares chave-valor)
   • As chaves devem ser únicas dentro de um objeto e colocadas entre aspas duplas ("chave").
     • (Alguns analisadores toleram aspas simples, mas evite isso por questões de compatibilidade.)
   • Os valores variam conforme o tipo:
     • String (texto): Entre aspas duplas.
     • Booleano: Usar true ou false.
     • Número: Seguir as regras de ponto flutuante de dupla precisão; notação científica é permitida. Evite zeros à esquerda.
     • Nulo: Representado por null.
     • Outros tipos (ex.: datas): Converter para string para garantir compatibilidade.
   • Caracteres especiais em strings devem ser escapados com barra invertida (\).
4. Regras de Sintaxe
   • Separe membros ou valores de array com vírgulas, exceto o último.
   • Extensão de arquivo: .json
   • Tipo MIME: application/json

Exemplo de JSON

{
  "anObject": {
    "numericProperty": -122,
    "stringProperty": "An offensive \" is problematic",
    "nullProperty": null,
    "booleanProperty": true,
    "dateProperty": "2011-09-23"
  },
  "arrayOfObjects": [
    { "item": 1 },
    { "item": 2 },
    { "item": 3 }
  ],
  "arrayOfIntegers": [1, 2, 3, 4, 5]
}

JSON em JavaScript

Como o JSON é derivado do JavaScript, ele se integra perfeitamente à linguagem. No entanto, é essencial tratá-lo com segurança para evitar erros e riscos de segurança.

Analisando Strings JSON

Evite usar eval()

eval() pode analisar JSON, mas representa um risco de segurança ao permitir a execução arbitrária de código JavaScript. Nunca use em produção.

Exemplo (Inseguro – Não usar):

var jsonString = '{"property":"value"}';
var jsonObject = eval('(' + jsonString + ')');
alert(jsonObject.property);

Use JSON.parse() em vez disso

JSON.parse() converte uma string JSON em um objeto JavaScript de forma segura.

Exemplo (Seguro):

var jsonString = '{"property":"value"}';
var jsonObject = JSON.parse(jsonString);
alert(jsonObject.property);

Criando Strings JSON

Use JSON.stringify() para converter um objeto JavaScript em uma string JSON.

Exemplo:

var jsObject = { property: "value" };
var jsonString = JSON.stringify(jsObject);
alert(jsonString); // Output: '{"property":"value"}'

Criando Objetos JavaScript Diretamente

Objetos JavaScript podem ser criados diretamente usando sintaxe JSON no código.

Exemplo:

var jsonObject = { property: "value" };
alert(jsonObject.property); // Output: 'value'

Boas Práticas e Recomendações

1. Use sempre aspas duplas para as chaves e valores string para garantir máxima compatibilidade.
2. Evite o uso de eval() ao analisar JSON, para prevenir vulnerabilidades de segurança.
3. Escape caracteres especiais em strings.
4. Use JSON.stringify() e JSON.parse() para manipular JSON de forma segura e eficiente.
5. Valide os dados JSON antes de analisá-los, especialmente se vierem de fontes não confiáveis.