<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

CRUD com JavaScript puro: código completo para o seu primeiro projeto sem frameworks

DA

8 min

CRUD com JavaScript puro: código completo para o seu primeiro projeto sem frameworks

Monte um CRUD completo com JavaScript puro, sem frameworks: código pronto, persistência no localStorage e próximos passos até um backend real.

Neste artigo

Este tutorial monta um CRUD completo com JavaScript puro: você cria, lista, edita e remove itens em uma página HTML, guarda tudo no localStorage do navegador e não usa nenhum framework. O código está completo, pronto para copiar, salvar e rodar.

As operações giram em torno de arrays, eventos e funções, e o guia de arrays e loops em JavaScript explica esses alicerces com mais profundidade. Volte lá se alguma linha não fizer sentido; o resto do texto assume só HTML básico.

O que é um CRUD e por que ele é o melhor primeiro projeto?

CRUD é a sigla de Create, Read, Update e Delete: criar, ler, atualizar e remover. Toda lista de tarefas, cadastro de clientes ou carrinho de compras faz essas quatro operações, e o que muda de um sistema para o outro é apenas o dado gerenciado.

Montar um do zero mostra como interface, estado e persistência se conectam dentro de um mesmo fluxo. Essa visão separa quem copia tutorial de quem entende o que escreve.

JavaScript puro, sem frameworks, é o formato certo para o primeiro contato: sem instalador, sem etapa de build, só o navegador. Quando um framework entrar na sua rotina, você vai saber exatamente o que ele automatiza.

Como o projeto salva dados sem banco de dados?

A persistência fica por conta do localStorage, espaço de armazenamento que o navegador mantém por origem (domínio e protocolo). Ele guarda apenas strings, então o padrão é serializar arrays e objetos com JSON.stringify ao salvar e converter de volta com JSON.parse ao carregar, como documenta a documentação do localStorage no MDN, mantida pela Mozilla.

O formato de chave e valor simplifica o exemplo: a chave nomes guarda a lista inteira em JSON. Em projetos reais, com volume e vários usuários, entra um servidor, mas a lógica das quatro operações continua a mesma.

Estrutura do projeto

São apenas três arquivos na mesma pasta, sem dependências e sem etapa de instalação, o que torna o exemplo fácil de abrir em qualquer computador:

crud-js/
  index.html
  style.css
  script.js

O HTML da interface

Crie o index.html com um campo de texto, um botão e uma lista vazia. Os ids nome e lista são os pontos de ligação com o JavaScript, e a tag script no fim do body garante que o código roda depois do HTML carregado.

<!DOCTYPE html>
<html lang="pt-BR">
<head>
  <meta charset="UTF-8">
  <title>CRUD Simples com JavaScript</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <h1>Cadastro de Nomes</h1>
  <input type="text" id="nome" placeholder="Digite um nome">
  <button onclick="adicionar()">Adicionar</button>
  <ul id="lista"></ul>
  <script src="script.js"></script>
</body>
</html>

O CSS mínimo

O estilo não precisa ser bonito, precisa ser legível. Este CSS limita a largura da página, dá respiro ao formulário e alinha cada item da lista com os botões de ação nas extremidades:

body {
  font-family: sans-serif;
  max-width: 480px;
  margin: 40px auto;
}

input {
  padding: 8px;
  width: 55%;
}

button {
  padding: 8px 12px;
  margin-left: 4px;
  cursor: pointer;
}

li {
  display: flex;
  justify-content: space-between;
  align-items: center;
  margin: 8px 0;
}

O JavaScript: as quatro operações

O estado do app é o array nomes, carregado do localStorage na abertura da página. A função salvar grava o array de volta e repinta a lista, e a renderizarLista recria cada item com os botões de editar e remover.

Recarregar a lista inteira a cada mudança é uma decisão proposital: evita manipulação fina do DOM, mantém a leitura simples e elimina uma classe inteira de bugs de interface.

let nomes = JSON.parse(localStorage.getItem('nomes')) || [];

function salvar() {
  localStorage.setItem('nomes', JSON.stringify(nomes));
  renderizarLista();
}

function renderizarLista() {
  const lista = document.getElementById('lista');
  lista.innerHTML = '';
  nomes.forEach((nome, index) => {
    const item = document.createElement('li');
    item.innerHTML = `${nome}
      <span>
        <button onclick="editar(${index})">Editar</button>
        <button onclick="remover(${index})">Remover</button>
      </span>`;
    lista.appendChild(item);
  });
}

A função adicionar lê o campo, descarta espaços nas pontas com trim e recusa texto vazio. A função editar usa prompt para receber o novo valor e repete as mesmas validações. Nenhuma das duas mexe no DOM direto: elas mudam o array e chamam salvar.

function adicionar() {
  const campo = document.getElementById('nome');
  const valor = campo.value.trim();
  if (valor === '') {
    alert('Digite um nome antes de adicionar.');
    return;
  }
  nomes.push(valor);
  campo.value = '';
  salvar();
}

function editar(index) {
  const resposta = prompt('Edite o nome:', nomes[index]);
  if (resposta === null) return;
  const valor = resposta.trim();
  if (valor === '') {
    alert('O nome não pode ficar vazio.');
    return;
  }
  nomes[index] = valor;
  salvar();
}

A remoção pede confirmação para evitar apagões acidentais e usa splice, que altera o array na posição indicada. No fim do arquivo, a chamada inicial renderiza a lista salva na última visita:

function remover(index) {
  if (!confirm('Remover este item?')) return;
  nomes.splice(index, 1);
  salvar();
}

renderizarLista();

Como rodar e testar o projeto

Salve os três arquivos na mesma pasta e abra o index.html no navegador, com um duplo clique. Não precisa de servidor para este exemplo. Adicione três nomes, recarregue a página com F5 e confirme que a lista continua lá: o localStorage sobrevive ao fechamento do navegador.

Para ver os dados brutos, abra o DevTools com F12 e procure a aba Application, seção Local Storage. A chave nomes aparece com o JSON gravado. Editar e remover devem refletir na hora, porque cada operação repinta a lista inteira.

💡 Dica: publique o projeto no GitHub Pages e coloque o link no currículo. Um CRUD funcional, mesmo simples, prova que você domina estado, eventos e persistência no navegador.

Erros comuns que travam iniciantes

O primeiro é esquecer o fallback do JSON.parse: sem o || [], a primeira execução com localStorage vazio quebra o script. O segundo é inserir texto do usuário via innerHTML sem tratamento, o que abre espaço para injeção de código.

O guia de XSS e SQL injection mostra esse risco de injeção em detalhe. O terceiro erro clássico é esquecer o trim e aceitar cadastro só de espaços em branco.

Um detalhe que confunde: prompt devolve null quando o usuário cancela. Sem checar isso, editar e cancelar gravaria a string null na lista. Valide sempre a resposta antes de gravar no array.

Próximos passos: do localStorage a um backend real

Com o CRUD rodando, evolua em camadas: valide e-mail com expressão regular, ordene a lista, transforme os botões em ícones e separe o código em módulos. Quando o localStorage ficar pequeno, migre para um servidor: a lógica de criar, ler, atualizar e apagar se repete do outro lado, como mostra o guia de CRUD com PostgreSQL.

Para trilhar o caminho completo da linguagem, siga o roadmap de JavaScript 2026 e o guia completo de JavaScript para iniciantes. Frameworks entram depois, e com bem menos mistério quando os fundamentos já estão na mão.

Perguntas frequentes

O que é CRUD em JavaScript?

É a implementação das quatro operações básicas de dados (criar, ler, atualizar e remover) direto no navegador, sem framework. No exemplo deste tutorial, os dados ficam em um array na memória e são persistidos no localStorage.

Preciso de banco de dados para fazer um CRUD?

Não para aprender. O localStorage substitui o banco no exemplo e mantém os dados no navegador. Banco de dados entra quando há vários usuários, dados sensíveis ou acesso de outros dispositivos.

Os dados do localStorage somem quando fecho o navegador?

Não. O localStorage persiste por origem até ser apagado manualmente ou pela limpeza de dados do site. A documentação do MDN detalha limites e comportamento por navegador.

Posso colocar esse projeto no currículo?

Sim, principalmente como iniciante. Publique no GitHub com um README explicando as quatro operações e, se possível, uma versão no GitHub Pages para demonstração ao vivo.

Qual a diferença entre CRUD com JavaScript puro e com frameworks?

A lógica é a mesma. O framework automatiza a atualização da tela quando o estado muda, algo que aqui é feito manualmente na renderizarLista. Entender a versão manual mostra o que o framework resolve.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 01/11/2026 •

Ver perfil do autor

COMPARTILHAR