React-Hook-Muster: Meisterung der Entwicklung benutzerdefinierter Hooks für globale Anwendungen

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

/**
 * Ein benutzerdefinierter Hook zur Verwaltung eines numerischen Zählers.
 * @param {number} initialValue - Der Anfangswert des Zählers. Standardmäßig 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);
  }, []); // Keine Abhängigkeiten, da setCount stabil ist

  const decrement = useCallback(() => {
    setCount(prevCount => prevCount - 1);
  }, []); // Keine Abhängigkeiten

  const reset = useCallback(() => {
    setCount(initialValue);
  }, [initialValue]); // Hängt von initialValue ab

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

export default useCounter;

            

              
                Copy
              
            
          

            
import React from 'react';
import useCounter from './useCounter'; // Angenommen, useCounter.js befindet sich im selben Verzeichnis

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

  return (
    <div>
      <h3>Aktueller Zählerstand: {count}</h3>
      <button onClick={increment}>Inkrementieren</button>
      <button onClick={decrement}>Dekrementieren</button>
      <button onClick={reset}>Zurücksetzen</button>
    </div>
  );
}

export default CounterComponent;

            

              
                Copy
              
            
          

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

/**
 * Ein benutzerdefinierter Hook zum Abrufen von Daten von einer API.
 * @param {string} url - Die URL, von der Daten abgerufen werden sollen.
 * @param {object} options - Fetch-Optionen (z. B. Header, Methode, Body).
 * @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(`HTTP-Fehler! Status: ${response.status}`);
      }
      const result = await response.json();
      setData(result);
    } catch (err) {
      setError(err);
    } finally {
      setLoading(false);
    }
  }, [url, JSON.stringify(options)]); // Optionen für einen tiefen Vergleich in einen String umwandeln

  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>Lade Benutzerprofil...</p>;
  if (error) return <p style={{ color: 'red' }}>Fehler: {error.message}</p>;
  if (!user) return <p>Keine Benutzerdaten gefunden.</p>;

  return (
    <div>
      <h2>{user.name}</h2>
      <p>E-Mail: {user.email}</p>
      <p>Standort: {user.location}</p>
      <!-- Weitere Benutzerdetails -->
    </div>
  );
}

export default UserProfile;

            

              
                Copy
              
            
          

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

/**
 * Ein benutzerdefinierter Hook, um den Zustand im localStorage zu persistieren.
 * @param {string} key - Der Schlüssel für den localStorage.
 * @param {any} initialValue - Der Anfangswert, falls keine Daten im localStorage gefunden werden.
 * @returns {[any, (value: any) => void]}
 */
function useLocalStorage(key, initialValue) {
  // Zustand zum Speichern unseres Wertes
  // Übergeben Sie die Funktion für den Anfangszustand an useState, damit die Logik nur einmal ausgeführt wird
  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(`Fehler beim Lesen des localStorage-Schlüssels "${key}":`, error);
      return initialValue;
    }
  });

  // useEffect, um den localStorage zu aktualisieren, wenn sich der Zustand ändert
  useEffect(() => {
    try {
      if (typeof window !== 'undefined') {
        window.localStorage.setItem(key, JSON.stringify(storedValue));
      }
    } catch (error) {
      console.error(`Fehler beim Schreiben in den localStorage-Schlüssel "${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'; // CSS-Klasse anwenden
  };

  return (
    <div>
      <p>Aktuelles Design: {isDarkMode ? '<strong>Dunkel</strong>' : '<strong>Hell</strong>'}</p>
      <button onClick={toggleTheme}>
        Zum {isDarkMode ? 'hellen' : 'dunklen'} Design wechseln
      </button>
    </div>
  );
}

export default ThemeSwitcher;

            

              
                Copy
              
            
          

            
import { useState, useCallback } from 'react';

/**
 * Ein benutzerdefinierter Hook zur Verwaltung eines booleschen Zustands.
 * @param {boolean} initialValue - Der anfängliche boolesche Wert. Standardmäßig 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}>Modal umschalten</button>
      {isOpen && (
        <div style={{
          border: '1px solid black', 
          padding: '20px', 
          margin: '10px', 
          backgroundColor: 'lightblue'
        }}>
          <h3>Dies ist ein Modal</h3>
          <p>Hier steht der Inhalt.</p>
          <button onClick={toggleOpen}>Modal schließen</button>
        </div>
      )}
    </div>
  );
}

export default ModalComponent;

            

              
                Copy
              
            
          

            
import { useEffect, useRef } from 'react';

/**
 * Ein benutzerdefinierter Hook zum Anhängen und Bereinigen von Event-Listenern.
 * @param {string} eventName - Der Name des Ereignisses (z. B. 'click', 'resize').
 * @param {function} handler - Die Ereignisbehandlungsfunktion.
 * @param {EventTarget} element - Das DOM-Element, an das der Listener angehängt werden soll. Standardmäßig window.
 * @param {object} options - Optionen für den Event-Listener (z. B. { capture: true }).
 */
function useEventListener(eventName, handler, element = window, options = {}) {
  // Erstellen Sie eine Ref, die den Handler speichert
  const savedHandler = useRef();

  // Aktualisieren Sie den ref.current-Wert, wenn sich der Handler ändert. Dies ermöglicht es dem Effekt unten,
  // immer den neuesten Handler zu verwenden, ohne den Event-Listener erneut anhängen zu müssen.
  useEffect(() => {
    savedHandler.current = handler;
  }, [handler]);

  useEffect(() => {
    // Stellen Sie sicher, dass das Element addEventListener unterstützt
    const isSupported = element && element.addEventListener;
    if (!isSupported) return;

    // Erstellen Sie einen Event-Listener, der savedHandler.current aufruft
    const eventListener = event => savedHandler.current(event);

    // Fügen Sie den Event-Listener hinzu
    element.addEventListener(eventName, eventListener, options);

    // Bereinigen Sie bei der De-Montage oder wenn sich Abhängigkeiten ändern
    return () => {
      element.removeEventListener(eventName, eventListener, options);
    };
  }, [eventName, element, options]); // Erneut ausführen, wenn sich eventName oder element ändert
}

export default useEventListener;

            

              
                Copy
              
            
          

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

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

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

  useEventListener('keydown', handleKeyPress);

  return (
    <div>
      <p>Drücken Sie eine beliebige Taste, um ihren Namen zu sehen:</p>
      <strong>Zuletzt gedrückte Taste: {key}</strong>
    </div>
  );
}

export default KeyPressDetector;

            

              
                Copy
              
            
          

            
import { useState, useCallback } from 'react';

/**
 * Ein benutzerdefinierter Hook zur Verwaltung des Formularzustands und zur Handhabung von Eingabeänderungen.
 * @param {object} initialValues - Ein Objekt mit den anfänglichen Werten der Formularfelder.
 * @param {object} validationRules - Ein Objekt mit Validierungsfunktionen für jedes Feld.
 * @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(); // Das Ereignis persistent machen, um es asynchron zu verwenden (falls erforderlich)
    const { name, value, type, checked } = event.target;

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

    // Fehler für das Feld löschen, sobald es geändert wird
    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] = `Ungültiges ${fieldName}`;
          // In einer echten App würden Sie spezifische Fehlermeldungen basierend auf der Regel bereitstellen
        }
      }
    }
    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(`Sende: E-Mail: ${formData.email}, Passwort: ${formData.password}`);
    // In einer echten App Daten an eine API senden
  };

  return (
    <form onSubmit={handleSubmit(submitLogin)}>
      <h2>Login</h2>
      <div>
        <label htmlFor="email">E-Mail:</label>
        <input
          type="email"
          id="email"
          name="email"
          value={values.email}
          onChange={handleChange}
        />
        {errors.email && <p style={{ color: 'red' }}>Ungültige E-Mail</p>}
      </div>
      <div>
        <label htmlFor="password">Passwort:</label>
        <input
          type="password"
          id="password"
          name="password"
          value={values.password}
          onChange={handleChange}
        />
        {errors.password && <p style={{ color: 'red' }}>Passwort muss mindestens 6 Zeichen lang sein</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);

// Benutzerdefinierter Hook für Authentifizierungslogik
export function useAuth() {
  const [user, setUser] = useState(null);
  const [isLoading, setIsLoading] = useState(true);

  // Simulieren einer asynchronen Login-Funktion
  const login = useCallback(async (username, password) => {
    setIsLoading(true);
    return new Promise(resolve => {
      setTimeout(() => {
        if (username === 'test' && password === 'password') {
          const userData = { id: '123', name: 'Globaler Benutzer' };
          setUser(userData);
          localStorage.setItem('user', JSON.stringify(userData));
          resolve(true);
        } else {
          resolve(false);
        }
        setIsLoading(false);
      }, 1000);
    });
  }, []);

  // Simulieren einer asynchronen Logout-Funktion
  const logout = useCallback(() => {
    setUser(null);
    localStorage.removeItem('user');
  }, []);

  // Benutzer beim Mounten aus dem localStorage laden
  useEffect(() => {
    const storedUser = localStorage.getItem('user');
    if (storedUser) {
      try {
        setUser(JSON.parse(storedUser));
      } catch (e) {
        console.error('Fehler beim Parsen des Benutzers aus dem localStorage', e);
        localStorage.removeItem('user');
      }
    }
    setIsLoading(false);
  }, []);

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

// AuthProvider-Komponente, um Ihre Anwendung oder Teile davon zu umschließen
export function AuthProvider({ children }) {
  const auth = useAuth(); // Hier wird unser benutzerdefinierter Hook verwendet

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

// Benutzerdefinierter Hook zum Konsumieren des AuthContext
export function useAuthContext() {
  const context = useContext(AuthContext);
  if (context === undefined) {
    throw new Error('useAuthContext muss innerhalb eines AuthProviders verwendet werden');
  }
  return context;
}

            

              
                Copy
              
            
          

            
// App.js (oder Wurzelkomponente)
import React from 'react';
import { AuthProvider, useAuthContext } from './AuthContext';

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

  if (isLoading) return <p>Lade Authentifizierungsstatus...</p>;
  if (!user) return <p>Bitte einloggen.</p>;

  return (
    <div>
      <h2>Willkommen, {user.name}!</h2>
      <button onClick={logout}>Logout</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('Login fehlgeschlagen!');
    }
  };

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

function App() {
  return (
    <AuthProvider>
      <h1>Auth-Beispiel mit benutzerdefiniertem Hook & Context</h1>
      <LoginFormForContext />
      <Dashboard />
    </AuthProvider>
  );
}

export default App;

            

              
                Copy
              
            
          

            
// Beispiel für AbortController in useFetch (zur Verdeutlichung vereinfacht)
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('Fetch abgebrochen');
        } else {
          setError(err);
        }
      })
      .finally(() => setLoading(false));

    return () => {
      // Fetch-Anfrage abbrechen, wenn die Komponente de-montiert wird oder sich Abhängigkeiten ändern
      abortController.abort();
    };
  }, [url]);

  return { data, error, loading };
}

export default useFetchAbortable;

            

              
                Copy
              
            
          

            
// Beispieltest für useCounter (konzeptionell)
import { renderHook, act } from '@testing-library/react-hooks';
import useCounter from './useCounter';

describe('useCounter', () => {
  it('sollte den Zählerstand inkrementieren', () => {
    const { result } = renderHook(() => useCounter(0));

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

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

  it('sollte den Zählerstand auf den Anfangswert zurücksetzen', () => {
    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);
  });

  // Weitere Tests für Dekrementieren, Anfangswert usw.
});

            

              
                Copy
              
            
          

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

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

  useEffect(() => {
    try {
      const date = new Date(dateString);
      setFormattedDate(date.toLocaleDateString(locale, options));
    } catch (e) {
      console.error('Ungültiger Datumsstring an useLocalizedDate übergeben:', dateString, e);
      setFormattedDate('Ungültiges Datum');
    }
  }, [dateString, locale, JSON.stringify(options)]);

  return formattedDate;
}

// Verwendung:
// const myDate = useLocalizedDate('2023-10-26T10:00:00Z', 'de-DE', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' });
// // myDate wäre 'Donnerstag, 26. Oktober 2023'

            

              
                Copy
              
            
          

            
import { useState, useEffect } from 'react';

/**
 * Ein benutzerdefinierter Hook, um einen Wert zu debouncen.
 * @param {any} value - Der zu debouncende Wert.
 * @param {number} delay - Die Verzögerung in Millisekunden.
 * @returns {any} Der debounced Wert.
 */
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 Verzögerung

  // Effekt zum Abrufen von Suchergebnissen basierend auf debouncedSearchTerm
  useEffect(() => {
    if (debouncedSearchTerm) {
      console.log(`Rufe Ergebnisse ab für: ${debouncedSearchTerm}`);
      // Hier API-Aufruf durchführen
    } else {
      console.log('Suchbegriff gelöscht.');
    }
  }, [debouncedSearchTerm]);

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

export default SearchInput;

            

              
                Copy