Datenvalidierung in JavaScript (Node.js): Joi, Yup, Zod

Datenvalidierung in Node.js: Joi, Yup und Zod — das richtige Werkzeug auswählen

In der modernen Webentwicklung mit Node.js ist Datenvalidierung nicht nur eine gute Praxis, sondern eine Notwendigkeit. Ohne sie riskiert Ihr Server, ungültige, schädliche oder einfach unerwartete Daten vom Client zu erhalten. Dies kann zu Fehlern in der Anwendungslogik, Sicherheitslücken (SQL-Injection, XSS) und instabilem Betrieb führen. In diesem Artikel betrachten wir die drei beliebtesten Bibliotheken zur Datenvalidierung in der Node.js-Umgebung: Joi, Yup und Zod. Sie erfahren ihre Besonderheiten, Vorteile und lernen, sie in der Praxis anzuwenden.

Warum ist serverseitige Validierung notwendig?

Viele Entwickler verlassen sich nur auf die Frontend-Validierung (z. B. mit HTML5-Attributen). Das ist ein Fehler. Die clientseitige Validierung kann leicht umgangen werden (durch Deaktivieren von JavaScript oder Senden einer Anfrage über Postman/curl). Die serverseitige Validierung ist die letzte Verteidigungslinie. Sie stellt sicher, dass nur Daten in Ihre Geschäftslogik und Datenbank gelangen, die strengen Anforderungen entsprechen: korrekter Typ, Länge, Format (E-Mail, URL), Pflichtfelder usw.

1. Joi — der bewährte Veteran

Joi (häufig mit dem Hapi.js-Framework verwendet, funktioniert aber auch hervorragend mit Express/Koa) ist eine der leistungsstärksten und flexibelsten Bibliotheken. Sie bietet eine umfangreiche API zur Beschreibung von Schemata und Fehlermeldungen.

Installation:

npm install joi

Beispiel für die Verwendung von Joi zur Validierung einer Benutzerregistrierung:

const Joi = require('joi');

const schema = Joi.object({    username: Joi.string()        .alphanum()        .min(3)        .max(30)        .required()        .messages({            'string.min': 'Der Benutzername muss mindestens {#limit} Zeichen lang sein',            'string.max': 'Der Benutzername darf maximal {#limit} Zeichen lang sein'        }),    password: Joi.string()        .pattern(new RegExp('^[a-zA-Z0-9]{3,30}$'))        .required(),    email: Joi.string()        .email({ minDomainSegments: 2, tlds: { allow: ['com', 'net', 'ru'] } })        .required(),    birth_year: Joi.number()        .integer()        .min(1900)        .max(2023)});

const validateUser = (data) => {    const { error, value } = schema.validate(data, { abortEarly: false });    if (error) {        // Alle Fehler zurückgeben        return { valid: false, errors: error.details.map(d => d.message) };    }    return { valid: true, data: value };};

// Beispielaufrufconst result = validateUser({    username: 'jo',    password: '123',    email: 'test@test',    birth_year: 1800});console.log(result.errors);// Ausgabe: ['Der Benutzername muss mindestens 3 Zeichen lang sein', '"password" length must be at least 3 characters long', '"email" must be a valid email', '"birth_year" must be less than or equal to 2023']

Vorteile von Joi:

• Sehr viele integrierte Validatoren (E-Mail, URL, UUID, Kreditkarte, Telefon usw.).
• Unterstützung für bedingte Validierung (when, switch).
• Hervorragende Fehlermeldungen mit Übersetzungs- und Anpassungsmöglichkeiten.
• Ausführliche Dokumentation.

Nachteile:

• Bibliotheksgröße (ca. 60 KB komprimiert).
• Die API kann für einfache Schemata umständlich wirken.
• Komplexe Integration mit TypeScript (zusätzliche Typen erforderlich).

2. Yup — Einfachheit und Komposition

Yup wurde ursprünglich für die Formularvalidierung in React (in Verbindung mit Formik) entwickelt, funktioniert aber auch auf dem Server hervorragend. Sein Hauptvorteil ist eine prägnante und lesbare Syntax, die an Mongoose-Schemata erinnert.

Installation:

npm install yup

Beispiel für die Validierung eines Objekt-Arrays mit Yup:

const yup = require('yup');

cons