Trabalhando com JSON

Se você é um desenvolvedor, provavelmente já ouviu falar sobre JSON (JavaScript Object Notation). Está em todo lugar! De APIs a arquivos de configuração, JSON é o formato ideal para troca de dados. Mas como trabalhamos com isso no Node.js? Vamos resumir em termos simples, com alguns exemplos do mundo real para ajudá-lo ao longo do caminho.

O que é JSON?

Em palavras simples, JSON é um formato para armazenar e trocar dados. É fácil de ler e escrever, o que o torna muito popular para desenvolvimento web. Fica assim:

{
  "name": "Alice",
  "age": 25,
  "city": "Wonderland"
}

É basicamente uma coleção de pares de valores-chave, como um objeto JavaScript. Mas lembre-se: JSON é apenas texto – ele precisa ser transformado em um objeto para ser útil em seu código.

Analisando JSON em Node.js

Vamos começar pegando uma string JSON e convertendo-a em algo com o qual possamos trabalhar: um objeto JavaScript. Fazemos isso usando JSON.parse().

Exemplo: análise de JSON

const jsonString = '{"name": "Alice", "age": 25, "city": "Wonderland"}';
const jsonObject = JSON.parse(jsonString);

console.log(jsonObject.name); // Output: Alice

Isso pega uma string JSON, analisa-a e a transforma em um objeto JavaScript. Agora você pode acessar suas propriedades como nome, idade ou cidade.

Convertendo objetos para JSON

E se você precisar enviar seus dados como JSON? É aí que entra JSON.stringify(). Ele pega seu objeto JavaScript e o transforma em uma string JSON.

Exemplo: convertendo um objeto em JSON

const user = {
  name: "Alice",
  age: 25,
  city: "Wonderland"
};

const jsonString = JSON.stringify(user);
console.log(jsonString);
// Output: {"name":"Alice","age":25,"city":"Wonderland"}

Isso é muito útil quando você está criando APIs ou armazenando dados como JSON.

Lendo e gravando arquivos JSON em Node.js

Precisa trabalhar com arquivos JSON? O Node.js facilita com o módulo fs (sistema de arquivos). Você pode ler e gravar arquivos JSON sem muitos problemas.

Exemplo: Lendo um arquivo JSON

const fs = require('fs');

fs.readFile('data.json', 'utf8', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }
  const jsonData = JSON.parse(data);
  console.log(jsonData);
});

Aqui, usamos fs.readFile() para ler o arquivo JSON e, em seguida, analisar o conteúdo do arquivo em um objeto JavaScript. Agora você pode fazer o que quiser com os dados!

Exemplo: Gravando em um arquivo JSON

const fs = require('fs');

const user = {
  name: "Alice",
  age: 25,
  city: "Wonderland"
};

fs.writeFile('output.json', JSON.stringify(user, null, 2), (err) => {
  if (err) {
    console.error(err);
    return;
  }
  console.log('Data saved to output.json');
});

Nesse caso, JSON.stringify() transforma o objeto em uma string JSON formatada e bonita e fs.writeFile() o salva em um arquivo. Fácil!

Envio e recebimento de JSON com solicitações HTTP

Ao construir APIs, JSON é o formato preferido para enviar e receber dados. No Express.js, você pode enviar e receber dados JSON sem esforço.

Exemplo: Envio de JSON em uma resposta

const express = require('express');
const app = express();

app.get('/user', (req, res) => {
  const user = { name: "Alice", age: 25, city: "Wonderland" };
  res.json(user);
});

app.listen(3000, () => console.log('Server running on port 3000'));

Aqui, enviamos um objeto JSON como resposta a uma solicitação HTTP GET. É tão simples quanto chamar res.json()!

Exemplo: Recebendo JSON em uma solicitação

app.use(express.json()); // Middleware to parse JSON body

app.post('/user', (req, res) => {
  const user = req.body;
  console.log(user); // Output: { name: "Alice", age: 25, city: "Wonderland" }
  res.send('User received!');
});

Neste exemplo, usamos o middleware express.json() para analisar automaticamente os dados JSON recebidos do corpo da solicitação, transformando-os em um objeto JavaScript que podemos usar.

Tratamento de erros JSON

E se você obtiver dados JSON incorretos? Não se preocupe – o Node.js possui tratamento de erros integrado. Vamos ver como detectar esses erros.

Exemplo: tratamento de erros de análise

const faultyJson = '{"name": "Alice", "age": 25'; // Oops, missing closing bracket

try {
  const jsonObj = JSON.parse(faultyJson);
} catch (error) {
  console.error('Failed to parse JSON:', error.message);
}

Se o JSON estiver quebrado, JSON.parse() gerará um erro. Nesse caso, o bloco try-catch nos ajuda a lidar com isso normalmente.

Concluindo

JSON é essencial se você estiver trabalhando com dados em Node.js. Esteja você analisando, criando, lendo ou enviando dados JSON, os métodos integrados no Node.js simplificam isso. Use JSON.parse() para transformar strings em objetos, JSON.stringify() para fazer o contrário e Express.js para manipulação suave de JSON em sua API.

Sinta-se confortável trabalhando com JSON e você terá uma das ferramentas mais valiosas em seu kit de ferramentas para desenvolvedores!

Referências:

1. Documentação do Node.js: Trabalhando com JSON
2. Guia Express.js: Tratamento de solicitações JSON
3. Documentos da Web MDN: JSON.parse()

Obrigado por ler e boa codificação! ?