Padrões de Hooks do React: Dominando o Desenvolvimento de Hooks Personalizados para Aplicações Globais

            
import React, { useState, useCallback } from 'react';

/**
 * Um hook personalizado para gerenciar um contador numérico.
 * @param {number} initialValue - O valor inicial do contador. O padrão é 0.
 * @returns {{ count: number, increment: () => void, decrement: () => void, reset: () => void }}
 */
function useCounter(initialValue = 0) {
  const [count, setCount] = useState(initialValue);

  const increment = useCallback(() => {
    setCount(prevCount => prevCount + 1);
  }, []); // Sem dependências, pois setCount é estável

  const decrement = useCallback(() => {
    setCount(prevCount => prevCount - 1);
  }, []); // Sem dependências

  const reset = useCallback(() => {
    setCount(initialValue);
  }, [initialValue]); // Depende de initialValue

  return {
    count,
    increment,
    decrement,
    reset
  };
}

export default useCounter;

            

              
                Copy
              
            
          

            
import React from 'react';
import useCounter from './useCounter'; // Assumindo que useCounter.js está no mesmo diretório

function CounterComponent() {
  const { count, increment, decrement, reset } = useCounter(10);

  return (
    <div>
      <h3>Contagem Atual: {count}</h3>
      <button onClick={increment}>Incrementar</button>
      <button onClick={decrement}>Decrementar</button>
      <button onClick={reset}>Redefinir</button>
    </div>
  );
}

export default CounterComponent;

            

              
                Copy
              
            
          

            
import React, { useState, useEffect, useCallback } from 'react';

/**
 * Um hook personalizado para buscar dados de uma API.
 * @param {string} url - A URL da qual buscar os dados.
 * @param {object} options - Opções de busca (ex: cabeçalhos, método, corpo).
 * @returns {{ data: any, loading: boolean, error: Error | null, refetch: () => void }}
 */
function useFetch(url, options = {}) {
  const [data, setData] = useState(null);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState(null);

  const fetchData = useCallback(async () => {
    setLoading(true);
    setError(null);
    try {
      const response = await fetch(url, options);
      if (!response.ok) {
        throw new Error(`Erro HTTP! status: ${response.status}`);
      }
      const result = await response.json();
      setData(result);
    } catch (err) {
      setError(err);
    } finally {
      setLoading(false);
    }
  }, [url, JSON.stringify(options)]); // Transforma as opções em string para comparação profunda

  useEffect(() => {
    fetchData();
  }, [fetchData]);

  return { data, loading, error, refetch: fetchData };
}

export default useFetch;

            

              
                Copy
              
            
          

            
import React from 'react';
import useFetch from './useFetch';

function UserProfile({ userId }) {
  const { data: user, loading, error } = useFetch(`https://api.example.com/users/${userId}`);

  if (loading) return <p>Carregando perfil do usuário...</p>;
  if (error) return <p style={{ color: 'red' }}>Erro: {error.message}</p>;
  if (!user) return <p>Nenhum dado de usuário encontrado.</p>;

  return (
    <div>
      <h2>{user.name}</h2>
      <p>Email: {user.email}</p>
      <p>Localização: {user.location}</p>
      <!-- Mais detalhes do usuário -->
    </div>
  );
}

export default UserProfile;

            

              
                Copy
              
            
          

            
import React, { useState, useEffect } from 'react';

/**
 * Um hook personalizado para persistir o estado no localStorage.
 * @param {string} key - A chave para o localStorage.
 * @param {any} initialValue - O valor inicial se nenhum dado for encontrado no localStorage.
 * @returns {[any, (value: any) => void]}
 */
function useLocalStorage(key, initialValue) {
  // Estado para armazenar nosso valor
  // Passa a função de estado inicial para o useState para que a lógica seja executada apenas uma vez
  const [storedValue, setStoredValue] = useState(() => {
    try {
      const item = typeof window !== 'undefined' ? window.localStorage.getItem(key) : null;
      return item ? JSON.parse(item) : initialValue;
    } catch (error) {
      console.error(`Erro ao ler a chave do localStorage "${key}":`, error);
      return initialValue;
    }
  });

  // useEffect para atualizar o localStorage quando o estado muda
  useEffect(() => {
    try {
      if (typeof window !== 'undefined') {
        window.localStorage.setItem(key, JSON.stringify(storedValue));
      }
    } catch (error) {
      console.error(`Erro ao escrever na chave do localStorage "${key}":`, error);
    }
  }, [key, storedValue]);

  return [storedValue, setStoredValue];
}

export default useLocalStorage;

            

              
                Copy
              
            
          

            
import React from 'react';
import useLocalStorage from './useLocalStorage';

function ThemeSwitcher() {
  const [isDarkMode, setIsDarkMode] = useLocalStorage('theme-preference', false);

  const toggleTheme = () => {
    setIsDarkMode(prevMode => !prevMode);
    document.body.className = isDarkMode ? '' : 'dark-theme'; // Aplica a classe CSS
  };

  return (
    <div>
      <p>Tema Atual: {isDarkMode ? '<strong>Escuro</strong>' : '<strong>Claro</strong>'}</p>
      <button onClick={toggleTheme}>
        Mudar para o Tema {isDarkMode ? 'Claro' : 'Escuro'}
      </button>
    </div>
  );
}

export default ThemeSwitcher;

            

              
                Copy
              
            
          

            
import { useState, useCallback } from 'react';

/**
 * Um hook personalizado para gerenciar um estado booleano.
 * @param {boolean} initialValue - O valor booleano inicial. O padrão é false.
 * @returns {[boolean, () => void, (value: boolean) => void]}
 */
function useToggle(initialValue = false) {
  const [value, setValue] = useState(initialValue);

  const toggle = useCallback(() => {
    setValue(prev => !prev);
  }, []);

  return [value, toggle, setValue];
}

export default useToggle;

            

              
                Copy
              
            
          

            
import React from 'react';
import useToggle from './useToggle';

function ModalComponent() {
  const [isOpen, toggleOpen] = useToggle(false);

  return (
    <div>
      <button onClick={toggleOpen}>Alternar Modal</button>
      {isOpen && (
        <div style={{
          border: '1px solid black', 
          padding: '20px', 
          margin: '10px', 
          backgroundColor: 'lightblue'
        }}>
          <h3>Este é um Modal</h3>
          <p>O conteúdo vai aqui.</p>
          <button onClick={toggleOpen}>Fechar Modal</button>
        </div>
      )}
    </div>
  );
}

export default ModalComponent;

            

              
                Copy
              
            
          

            
import { useEffect, useRef } from 'react';

/**
 * Um hook personalizado para anexar e limpar escutas de eventos.
 * @param {string} eventName - O nome do evento (ex: 'click', 'resize').
 * @param {function} handler - A função de manipulação do evento.
 * @param {EventTarget} element - O elemento do DOM ao qual anexar a escuta. O padrão é window.
 * @param {object} options - Opções da escuta de evento (ex: { capture: true }).
 */
function useEventListener(eventName, handler, element = window, options = {}) {
  // Cria uma ref que armazena o manipulador
  const savedHandler = useRef();

  // Atualiza o valor de ref.current se o manipulador mudar. Isso permite que o efeito abaixo
  // use sempre o manipulador mais recente sem precisar re-anexar a escuta de evento.
  useEffect(() => {
    savedHandler.current = handler;
  }, [handler]);

  useEffect(() => {
    // Garante que o elemento suporta addEventListener
    const isSupported = element && element.addEventListener;
    if (!isSupported) return;

    // Cria a escuta de evento que chama savedHandler.current
    const eventListener = event => savedHandler.current(event);

    // Adiciona a escuta de evento
    element.addEventListener(eventName, eventListener, options);

    // Limpa na desmontagem ou quando as dependências mudam
    return () => {
      element.removeEventListener(eventName, eventListener, options);
    };
  }, [eventName, element, options]); // Re-executa se eventName ou element mudar
}

export default useEventListener;

            

              
                Copy
              
            
          

            
import React, { useState } from 'react';
import useEventListener from './useEventListener';

function KeyPressDetector() {
  const [key, setKey] = useState('Nenhuma');

  const handleKeyPress = (event) => {
    setKey(event.key);
  };

  useEventListener('keydown', handleKeyPress);

  return (
    <div>
      <p>Pressione qualquer tecla para ver seu nome:</p>
      <strong>Última Tecla Pressionada: {key}</strong>
    </div>
  );
}

export default KeyPressDetector;

            

              
                Copy
              
            
          

            
import { useState, useCallback } from 'react';

/**
 * Um hook personalizado para gerenciar o estado do formulário e manipular as mudanças de input.
 * @param {object} initialValues - Um objeto com os valores iniciais dos campos do formulário.
 * @param {object} validationRules - Um objeto com funções de validação para cada campo.
 * @returns {{ values: object, errors: object, handleChange: (e: React.ChangeEvent) => void, handleSubmit: (callback: (values: object) => void) => (e: React.FormEvent) => void, resetForm: () => void }}
 */
function useForm(initialValues, validationRules = {}) {
  const [values, setValues] = useState(initialValues);
  const [errors, setErrors] = useState({});

  const handleChange = useCallback((event) => {
    event.persist(); // Persiste o evento para usá-lo de forma assíncrona (se necessário)
    const { name, value, type, checked } = event.target;

    setValues((prevValues) => ({
      ...prevValues,
      [name]: type === 'checkbox' ? checked : value,
    }));

    // Limpa o erro para o campo assim que ele é alterado
    if (errors[name]) {
      setErrors((prevErrors) => {
        const newErrors = { ...prevErrors };
        delete newErrors[name];
        return newErrors;
      });
    }
  }, [errors]);

  const validate = useCallback(() => {
    const newErrors = {};
    for (const fieldName in validationRules) {
      if (validationRules.hasOwnProperty(fieldName)) {
        const rule = validationRules[fieldName];
        const value = values[fieldName];
        if (rule && !rule(value)) {
          newErrors[fieldName] = `${fieldName} inválido`;
          // Numa aplicação real, você forneceria mensagens de erro específicas com base na regra
        }
      }
    }
    setErrors(newErrors);
    return Object.keys(newErrors).length === 0;
  }, [values, validationRules]);

  const handleSubmit = useCallback((callback) => (event) => {
    event.preventDefault();
    const isValid = validate();
    if (isValid) {
      callback(values);
    }
  }, [values, validate]);

  const resetForm = useCallback(() => {
    setValues(initialValues);
    setErrors({});
  }, [initialValues]);

  return {
    values,
    errors,
    handleChange,
    handleSubmit,
    resetForm,
  };
}

export default useForm;

            

              
                Copy
              
            
          

            
import React from 'react';
import useForm from './useForm';

const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;

function LoginForm() {
  const { values, errors, handleChange, handleSubmit } = useForm(
    { email: '', password: '' },
    {
      email: (value) => emailRegex.test(value) && value.length > 0,
      password: (value) => value.length >= 6,
    }
  );

  const submitLogin = (formData) => {
    alert(`Enviando: Email: ${formData.email}, Senha: ${formData.password}`);
    // Numa aplicação real, envie os dados para uma API
  };

  return (
    <form onSubmit={handleSubmit(submitLogin)}>
      <h2>Login</h2>
      <div>
        <label htmlFor="email">Email:</label>
        <input
          type="email"
          id="email"
          name="email"
          value={values.email}
          onChange={handleChange}
        />
        {errors.email && <p style={{ color: 'red' }}>{errors.email}</p>}
      </div>
      <div>
        <label htmlFor="password">Senha:</label>
        <input
          type="password"
          id="password"
          name="password"
          value={values.password}
          onChange={handleChange}
        />
        {errors.password && <p style={{ color: 'red' }}>{errors.password}</p>}
      </div>
      <button type="submit">Login</button>
    </form>
  );
}

export default LoginForm;

            

              
                Copy
              
            
          

            
// AuthContext.js
import React, { createContext, useContext, useState, useEffect, useCallback } from 'react';

const AuthContext = createContext(null);

// Hook Personalizado para Lógica de Autenticação
export function useAuth() {
  const [user, setUser] = useState(null);
  const [isLoading, setIsLoading] = useState(true);

  // Simula uma função de login assíncrona
  const login = useCallback(async (username, password) => {
    setIsLoading(true);
    return new Promise(resolve => {
      setTimeout(() => {
        if (username === 'test' && password === 'password') {
          const userData = { id: '123', name: 'Usuário Global' };
          setUser(userData);
          localStorage.setItem('user', JSON.stringify(userData));
          resolve(true);
        } else {
          resolve(false);
        }
        setIsLoading(false);
      }, 1000);
    });
  }, []);

  // Simula uma função de logout assíncrona
  const logout = useCallback(() => {
    setUser(null);
    localStorage.removeItem('user');
  }, []);

  // Carrega o usuário do localStorage na montagem
  useEffect(() => {
    const storedUser = localStorage.getItem('user');
    if (storedUser) {
      try {
        setUser(JSON.parse(storedUser));
      } catch (e) {
        console.error('Falha ao analisar o usuário do localStorage', e);
        localStorage.removeItem('user');
      }
    }
    setIsLoading(false);
  }, []);

  return { user, isLoading, login, logout };
}

// Componente AuthProvider para envolver sua aplicação ou partes dela
export function AuthProvider({ children }) {
  const auth = useAuth(); // É aqui que nosso hook personalizado é usado

  return (
    <AuthContext.Provider value={auth}>
      {children}
    </AuthContext.Provider>
  );
}

// Hook Personalizado para consumir o AuthContext
export function useAuthContext() {
  const context = useContext(AuthContext);
  if (context === undefined) {
    throw new Error('useAuthContext deve ser usado dentro de um AuthProvider');
  }
  return context;
}

            

              
                Copy
              
            
          

            
// App.js (ou componente raiz)
import React from 'react';
import { AuthProvider, useAuthContext } from './AuthContext';

function Dashboard() {
  const { user, isLoading, logout } = useAuthContext();

  if (isLoading) return <p>Carregando status da autenticação...</p>;
  if (!user) return <p>Por favor, faça o login.</p>;

  return (
    <div>
      <h2>Bem-vindo(a), {user.name}!</h2>
      <button onClick={logout}>Sair</button>
    </div>
  );
}

function LoginFormForContext() {
  const { login } = useAuthContext();
  const [username, setUsername] = useState('');
  const [password, setPassword] = useState('');

  const handleLogin = async (e) => {
    e.preventDefault();
    const success = await login(username, password);
    if (!success) {
      alert('Falha no login!');
    }
  };

  return (
    <form onSubmit={handleLogin}>
      <input type="text" placeholder="Usuário" value={username} onChange={e => setUsername(e.target.value)} />
      <input type="password" placeholder="Senha" value={password} onChange={e => setPassword(e.target.value)} />
      <button type="submit">Login</button>
    </form>
  );
}

function App() {
  return (
    <AuthProvider>
      <h1>Exemplo de Autenticação com Hook Personalizado & Contexto</h1>
      <LoginFormForContext />
      <Dashboard />
    </AuthProvider>
  );
}

export default App;

            

              
                Copy
              
            
          

            
// Exemplo de AbortController no useFetch (simplificado para clareza)
import React, { useState, useEffect } from 'react';

function useFetchAbortable(url) {
  const [data, setData] = useState(null);
  const [error, setError] = useState(null);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    const abortController = new AbortController();
    const signal = abortController.signal;

    setLoading(true);
    setError(null);

    fetch(url, { signal })
      .then(response => {
        if (!response.ok) throw new Error(response.statusText);
        return response.json();
      })
      .then(setData)
      .catch(err => {
        if (err.name === 'AbortError') {
          console.log('Busca abortada');
        } else {
          setError(err);
        }
      })
      .finally(() => setLoading(false));

    return () => {
      // Aborta a requisição de busca se o componente for desmontado ou as dependências mudarem
      abortController.abort();
    };
  }, [url]);

  return { data, error, loading };
}

export default useFetchAbortable;

            

              
                Copy
              
            
          

            
// Exemplo de teste para useCounter (conceitual)
import { renderHook, act } from '@testing-library/react-hooks';
import useCounter from './useCounter';

describe('useCounter', () => {
  it('deve incrementar o contador', () => {
    const { result } = renderHook(() => useCounter(0));

    act(() => {
      result.current.increment();
    });

    expect(result.current.count).toBe(1);
  });

  it('deve redefinir o contador para o valor inicial', () => {
    const { result } = renderHook(() => useCounter(5));

    act(() => {
      result.current.increment();
    });
    expect(result.current.count).toBe(6);

    act(() => {
      result.current.reset();
    });
    expect(result.current.count).toBe(5);
  });

  // Mais testes para decremento, valor inicial, etc.
});

            

              
                Copy
              
            
          

            
// Hook conceitual useLocalizedDate
import { useState, useEffect } from 'react';

function useLocalizedDate(dateString, locale = 'pt-BR', options = {}) {
  const [formattedDate, setFormattedDate] = useState('');

  useEffect(() => {
    try {
      const date = new Date(dateString);
      setFormattedDate(date.toLocaleDateString(locale, options));
    } catch (e) {
      console.error('String de data inválida fornecida para useLocalizedDate:', dateString, e);
      setFormattedDate('Data Inválida');
    }
  }, [dateString, locale, JSON.stringify(options)]);

  return formattedDate;
}

// Uso:
// const myDate = useLocalizedDate('2023-10-26T10:00:00Z', 'pt-BR', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' });
// // myDate seria 'quinta-feira, 26 de outubro de 2023'

            

              
                Copy
              
            
          

            
import { useState, useEffect } from 'react';

/**
 * Um hook personalizado para aplicar debounce a um valor.
 * @param {any} value - O valor para aplicar debounce.
 * @param {number} delay - O atraso em milissegundos.
 * @returns {any} O valor com debounce.
 */
function useDebounce(value, delay) {
  const [debouncedValue, setDebouncedValue] = useState(value);

  useEffect(() => {
    const handler = setTimeout(() => {
      setDebouncedValue(value);
    }, delay);

    return () => {
      clearTimeout(handler);
    };
  }, [value, delay]);

  return debouncedValue;
}

export default useDebounce;

            

              
                Copy
              
            
          

            
import React, { useState } from 'react';
import useDebounce from './useDebounce';

function SearchInput() {
  const [searchTerm, setSearchTerm] = useState('');
  const debouncedSearchTerm = useDebounce(searchTerm, 500); // 500ms de atraso

  // Efeito para buscar resultados da pesquisa com base no debouncedSearchTerm
  useEffect(() => {
    if (debouncedSearchTerm) {
      console.log(`Buscando resultados para: ${debouncedSearchTerm}`);
      // Faça a chamada da API aqui
    } else {
      console.log('Termo de busca limpo.');
    }
  }, [debouncedSearchTerm]);

  return (
    <div>
      <input
        type="text"
        placeholder="Pesquisar..."
        value={searchTerm}
        onChange={(e) => setSearchTerm(e.target.value)}
      />
      <p>Procurando por: <strong>{debouncedSearchTerm || '...'}</strong></p>
    </div>
  );
}

export default SearchInput;

            

              
                Copy