Construindo Custom Hooks no React: Extração e Reutilização de Lógica Pura
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.
📑 Índice do Conteúdo
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:
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.
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).
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
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
function useToggle(initial) { ... }
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:
-
Prefixo Obrigatório
use: Seu hook deve se chamaruseToggle,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. -
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.
// 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.
// 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:
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
useCallbackpara que componentes memoizados comReact.memorecebam referências imutáveis e não re-renderizem à toa. - Testes Unitários sem Componentes Falsos: Utilize o utilitário
renderHookda biblioteca@testing-library/reactpara 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!
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.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground 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