Custom Hooks no React: Extração de Lógica Reutilizável
⚡ Curso de React.js • Web-ZoneWare

Construindo Custom Hooks no React: Extração e Reutilização de Lógica Pura

Lição 41 de 50

Construindo Custom Hooks no React: Extração e Reutilização de Lógica Pura

Módulo 5 • Lição 41 (82% do Curso • Pauta Satélite 386)

Construindo Custom Hooks no React: Extração e Reutilização de Lógica Pura

No desenvolvimento profissional com React, componentes limpos delegam sua lógica de negócio e seus efeitos colaterais para funções especializadas. Aprenda a criar Custom Hooks do zero, entenda por que eles compartilham lógica de estado e não o estado em si, e eleve a manutenibilidade das suas aplicações seguindo os mais rigorosos padrões da engenharia de software moderna.

1. A Evolução do Compartilhamento de Lógica no React

Desde as primeiras versões do React, a reutilização de lógica entre componentes sempre foi um dos tópicos mais discutidos da arquitetura frontend. Ao longo dos anos, o ecossistema passou por três grandes eras:

React 0.13 (Obsoleto)

Mixins em Componentes de Classe

Mesclavam métodos e estados em objetos de classe de forma implícita. Causavam colisões de nomes, dependências ocultas e código frágil extremamente difícil de refatorar.

React 15 – 16

Higher-Order Components (HOCs) e Render Props

Padrões funcionais poderosos, porém propensos ao temido Wrapper Hell (aninhamento excessivo de componentes na árvore de visualização, prejudicando debug e legibilidade).

React 16.8 até React 19 (Padrão Ouro)

Custom Hooks (Hooks Customizados)

Funções JavaScript puras com acesso nativo aos primitivos de estado e efeitos do React. Sem poluição da árvore DOM, com tipagem transparente e composição direta.

O que é, tecnicamente, um Custom Hook?

Um Custom Hook não é nada mágico: é simplesmente uma função JavaScript convencional cujo nome começa obrigatoriamente com o prefixo use e que invoca outros hooks do React (como useState, useEffect, useCallback ou até outros Custom Hooks) internamente.

2. A Regra de Ouro: Compartilhamento de Lógica vs. Compartilhamento de Estado

Conceito Crucial para Entrevistas e Arquitetura:
Custom Hooks compartilham a mecânica e lógica de manipulação de estado, mas NÃO compartilham o valor do estado em si. Cada vez que um componente invoca um Custom Hook, uma instância de estado completamente isolada e independente é alocada no Fiber Node correspondente daquele componente.

Componente A (ex: CardPerfil)

const [isOpen, toggle] = useToggle();

Estado Local A: false

← Lógica Reutilizada →
Custom Hook: useToggle()
function useToggle(initial) { ... }
← Lógica Reutilizada →

Componente B (ex: MenuModal)

const [isOpen, toggle] = useToggle();

Estado Local B: true

Figura 41.1: Múltiplos componentes utilizam a mesma definição do hook useToggle(), porém cada um mantém seu próprio ciclo de vida e estado booleano independente no DOM.

3. Convenções e as Regras Estritas dos Hooks

Como qualquer hook no React, seus Custom Hooks devem cumprir rigorosamente as duas leis invioláveis dos Hooks:

  1. Prefixo Obrigatório use: Seu hook deve se chamar useToggle, useCounter, useWindowSize, etc. Essa convenção é exigida pelo linter oficial (eslint-plugin-react-hooks) para inspecionar automaticamente violações de regras de hooks no seu código.
  2. Chamada Somente no Topo: Nunca invoque outros hooks dentro de condicionais (if), laços de repetição (for/while) ou callbacks aninhados dentro do seu Custom Hook. A ordem das chamadas de hooks deve ser previsível e constante a cada re-renderização.

4. Padrões de Retorno: Tuplas (Arrays) vs. Objetos

A decisão de como o seu Custom Hook retorna seus valores impacta diretamente a ergonomia e a facilidade de uso pelos desenvolvedores consumidores:

1. Retorno por Tupla / Array [val, actions]

Inspirado no useState. Recomendado quando o hook expõe apenas 1 ou 2 valores.

JavaScript 10 linhas
// Definição
function useToggle(initial = false) {
  const [val, setVal] = useState(initial);
  const toggle = useCallback(() => setVal(v => !v), []);
  return [val, toggle];
}
 
// Consumo: renomeação trivial sem sintaxe extra!
const [isModalOpen, toggleModal] = useToggle();
const [isDropdownActive, toggleDropdown] = useToggle();

Vantagem: Renomeação de variáveis rápida e intuitiva.

2. Retorno por Objeto { val1, val2, act }

Recomendado quando o hook retorna 3 ou mais valores, ou quando a API pode evoluir no futuro.

JavaScript 11 linhas
// Definição
function useCounter({ min = 0, max = 100, initial = 0 } = {}) {
  const [count, setCount] = useState(initial);
  const inc = useCallback(() => setCount(c => Math.min(c + 1, max)), [max]);
  const dec = useCallback(() => setCount(c => Math.max(c - 1, min)), [min]);
  const reset = useCallback(() => setCount(initial), [initial]);
  return { count, inc, dec, reset };
}
 
// Consumo: seleção pontual sem depender da ordem
const { count, inc, reset } = useCounter({ max: 10 });

Vantagem: Independência da ordem posicional e facilidade de extensão.

5. Construindo o Custom Hook `useToggle` com Estabilidade Referencial

Vamos construir um Custom Hook de alternância booleana com nível de qualidade para design systems. Observe como o uso do useCallback na função de mutação assegura que ela não altere sua referência de memória a cada renderização do componente consumidor:

JavaScript 21 linhas
import { useState, useCallback } from 'react';
 
/**
 * Custom Hook useToggle
 * @param {boolean} initialValue - Estado booleano inicial
 * @returns {[boolean, () => void, (val: boolean) => void]} Tupla com valor, toggle e setter direto
 */
export function useToggle(initialValue = false) {
    const [value, setValue] = useState(Boolean(initialValue));
 
    // Estabilização referencial para uso seguro em componentes filhos memoizados
    const toggle = useCallback(() => {
        setValue(prev => !prev);
    }, []);
 
    const setSpecific = useCallback((val) => {
        setValue(Boolean(val));
    }, []);
 
    return [value, toggle, setSpecific];
}

6. Boas Práticas de Engenharia e Testabilidade

  • Princípio da Responsabilidade Única (SRP): Mantenha cada Custom Hook focado em uma tarefa específica. Se um hook estiver cuidando de requisições HTTP, autenticação de sessão e animações de scroll ao mesmo tempo, divida-o em hooks menores compostos.
  • Estabilidade de Ações: Sempre envolva funções de mutação retornadas em useCallback para que componentes memoizados com React.memo recebam referências imutáveis e não re-renderizem à toa.
  • Testes Unitários sem Componentes Falsos: Utilize o utilitário renderHook da biblioteca @testing-library/react para executar e testar as asserções do seu hook em ambiente de teste automatizado de forma limpa e isolada.

Laboratório Prático no Playground Web IDE

Experimente no editor abaixo a implementação ao vivo dos Custom Hooks useToggle e useCounter. Teste múltiplos botões e observe como cada instância gerencia seu próprio ciclo de vida de forma completamente independente!

🛠️ Laboratório Prático & Prática Imediata

Aplique o que você aprendeu nesta lição

Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground Web Online

Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.

⚡ Codificar no Playground IDE
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima