O que é JSON? Uma explicação completa da notação de objetos JavaScript
Resposta rápida
JSON é um formato de texto para representar dados estruturados usando pares de valores-chave e matrizes. Ele suporta seis tipos de dados: string, número, booleano, nulo, objeto e array. JSON é o formato padrão para troca de dados entre servidores web e navegadores. Use nosso formatador JSON gratuito para embelezar e validar JSON em seu navegador.
Introdução
JSON (JavaScript Object Notation) é um formato leve de intercâmbio de dados baseado em texto que é fácil de ser lido e escrito por humanos e fácil de ser analisado e gerado por máquinas. Apesar do nome, JSON é independente de linguagem – é usado por Python, Java, Go, Ruby e praticamente todas as linguagens de programação modernas, não apenas JavaScript. JSON é definido pela RFC 8259 e é o formato de dados dominante para web APIs, arquivos de configuração e bancos de dados NoSQL.
Passo a passo
-
Compreender a sintaxe JSON
JSON usa chaves {} para objetos (pares chave-valor), colchetes [] para matrizes (listas ordenadas) e dois pontos para separar chaves de valores. As chaves devem ser strings entre aspas duplas. Os valores podem ser strings, números, booleanos, nulos, objetos ou matrizes.
-
Aprenda os seis tipos de dados
JSON suporta exatamente seis tipos de dados: string (entre aspas duplas), número (sem distinção entre int/float), booleano (verdadeiro ou falso), nulo, objeto ({...}) e array ([...]). JSON não oferece suporte a indefinidos, funções, datas ou NaN.
-
Reconhecer a estrutura JSON
Um documento JSON é um objeto ou uma matriz de nível superior. Os objetos contêm pares de valores-chave; matrizes contêm valores ordenados. As estruturas podem ser aninhadas em qualquer profundidade — um valor de objeto pode ser outro objeto ou array.
-
Analisar e gerar JSON
Em JavaScript, JSON.parse(string) converte uma string JSON em um objeto JavaScript e JSON.stringify(object) converte um objeto JavaScript em uma string JSON. Toda linguagem moderna tem funções equivalentes.
Exemplos
Um objeto JSON simples
Entrada: Pessoa com nome e idade
Saída: {"name": "Alice", "age": 30}
JSON com estrutura aninhada
Entrada: Usuário com endereço
Saída: {"name": "Alice", "address": {"city": "NYC", "zip": "10001"}}
Matriz JSON
Entrada: Lista de números
Saída: [1, 2, 3, 4, 5]
Problemas comuns
- O uso de aspas simples —JSON requer aspas duplas para todas as strings e chaves. Aspas simples são inválidas.
- Vírgulas finais — uma vírgula após o último item em um objeto ou array é um erro de sintaxe em JSON.
- Comentários —padrão JSON não suporta comentários. Use JSONC ou JSON5 se precisar de comentários.
- Chaves sem aspas — ao contrário dos literais de objetos JavaScript, JSON exige que todas as chaves estejam entre aspas duplas.
Dicas
- JSON é independente de idioma, apesar do nome - toda linguagem moderna tem suporte para JSON.
- Use JSON para solicitações e respostas API — é o padrão de fato, substituindo XML.
- Valide JSON antes de enviá-lo em uma solicitação API para evitar 400 erros.
- Use nosso formatador JSON para embelezar, validar e reduzir JSON instantaneamente em seu navegador.