0Pricing
Next.js 15 Fullstack (App Router + Server Actions) · Aula

Mutação de dados e revalidação

Aprenda como as Server Actions podem alterar dados no servidor e revalidar automaticamente os dados armazenados em cache para atualizar a interface.

Mutação de dados e revalidação é uma aula grátis de Next.js 15 Fullstack (App Router + Server Actions) no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Next.js 15 Fullstack (App Router + Server Actions), e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Next.js 15 Fullstack (App Router + Server Actions) inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

What is Data Mutation?

In web development, data mutation means changing data on the server. This includes creating new data, updating existing records, or deleting data.

  • Create: Adding a new user.
  • Update: Changing a user's email.
  • Delete: Removing an item from a list.

Most interactive web applications rely heavily on data mutation to provide dynamic experiences.

Server Actions for Mutations

Next.js 15's Server Actions are perfect for handling data mutations. They allow you to run server-side code directly from your React components, making it simple to update your backend.

Instead of creating API routes for every data change, you can define these actions right where they're needed, keeping your code organized and efficient.

The Cache Challenge

When you mutate data on the server, the client-side UI often doesn't automatically reflect these changes. This is because Next.js (and browsers) aggressively cache data to improve performance.

If the UI still shows old, cached data after a server update, users see outdated information. We need a way to tell Next.js: "Hey, this data has changed, please get the fresh version!"

Revalidating with `revalidatePath`

To ensure your UI shows the latest data, Next.js provides caching utilities. One common method is revalidatePath.

After a Server Action changes data, you can call revalidatePath('/') to tell Next.js to invalidate the cache for the specified path (e.g., the home page) and refetch its data on the next request.

Demo: Update & Revalidate Path

This example shows a simple form that adds a task using a Server Action. After the task is added, revalidatePath('/') ensures that any data displayed on the root page (like a list of tasks) is refreshed.

import { revalidatePath } from 'next/cache';

async function addTask(formData) {
  'use server';
  const task = formData.get('task');
  // Simulate saving to a database
  console.log('Adding task:', task);
  await new Promise(r => setTimeout(r, 500));

  // Revalidate the home page to show new tasks
  revalidatePath('/');
}

export default function Page() {
  return (
    <div>
      <h1>My Task List</h1>
      <form action={addTask}>
        <input type="text" name="task" placeholder="New task" required />
        <button type="submit">Add Task</button>
      </form>
      <p>Task list will refresh after adding!</p>
    </div>
  );
}

Granular Control with `revalidateTag`

Sometimes you need more granular control over caching than just revalidating an entire path. This is where revalidateTag comes in.

When fetching data, you can assign a custom tag using the fetch API. Then, after a mutation, you can use revalidateTag('my-data-tag') to invalidate only the data associated with that specific tag.

When to use `revalidateTag`

Use revalidateTag when:

  • Data is fetched from an external API using fetch.
  • The data is shared across multiple pages or components.
  • You want to update specific data without re-rendering entire pages.

It's ideal for scenarios like updating a single user's profile data that might appear on various pages.

Post-Mutation Redirection

After a successful data mutation, you often want to redirect the user to another page (e.g., a success page or the updated list page). Next.js provides a redirect helper for this.

You can use redirect('/dashboard') inside your Server Action to send the user to the dashboard after a form submission.

Full Flow: Mutate, Revalidate, Redirect

This example combines all concepts: a form submission triggers a Server Action, which mutates data, revalidates the relevant path, and then redirects the user to a confirmation page.

import { revalidatePath, redirect } from 'next/cache';

async function createPost(formData) {
  'use server';
  const title = formData.get('title');
  const content = formData.get('content');

  // Simulate saving new post to a DB
  console.log('New Post:', { title, content });
  await new Promise(r => setTimeout(r, 700));

  revalidatePath('/posts'); // Revalidate the posts list page
  redirect('/posts/success'); // Redirect to a success page
}

export default function NewPostPage() {
  return (
    <div>
      <h1>Create New Post</h1>
      <form action={createPost}>
        <input type="text" name="title" placeholder="Title" required />
        <textarea name="content" placeholder="Content" required />
        <button type="submit">Publish Post</button>
      </form>
    </div>
  );
}

Quick Check on Revalidation

A Server Action successfully creates a new product and you want to update the product listing page (/products) and also ensure any cached data specifically tagged 'featured-products' is refreshed. Which revalidation methods should you use?

Recap: Mutate & Revalidate

Great job! You've learned how Server Actions are key to mutating data on the server. You also mastered how to keep your UI fresh:

  • Use Server Actions for creating, updating, or deleting data.
  • Employ revalidatePath to refresh data for specific routes.
  • Utilize revalidateTag for fine-grained cache invalidation of tagged fetch requests.
  • Use redirect to guide users after a successful action.

This powerful combination ensures your Next.js applications are always showing accurate, up-to-date information.

Perguntas Frequentes

A aula “Mutação de dados e revalidação” é grátis?

Sim — o texto completo de “Mutação de dados e revalidação” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Next.js 15 Fullstack (App Router + Server Actions), atualize para CoddyKit PRO. O curso de Next.js 15 Fullstack (App Router + Server Actions) inclui 4 aulas no total.

O que vou aprender em “Mutação de dados e revalidação”?

Aprenda como as Server Actions podem alterar dados no servidor e revalidar automaticamente os dados armazenados em cache para atualizar a interface. Você pratica Next.js 15 Fullstack (App Router + Server Actions) com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Next.js 15 Fullstack (App Router + Server Actions)?

Nenhuma experiência prévia é necessária. Next.js 15 Fullstack (App Router + Server Actions) no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Mutação de dados e revalidação”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Next.js 15 Fullstack (App Router + Server Actions)?

Sim. Cada aula de Next.js 15 Fullstack (App Router + Server Actions) inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Formulários básicos com Server Actions
  2. Mutação de dados e revalidação
  3. Tratamento de erros em ações
  4. Interface Otimista e Estados Pendentes com Ações de Servidor
← Voltar para Next.js 15 Fullstack (App Router + Server Actions)