Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Zod med JavaScript

Lektion 7 af 12 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Strukturerede outputs i JavaScript
  2. Installation
  3. Klientkonfiguration
  4. Definition af et skema med Zod
  5. Typemapping
  6. Komplet eksempel
  7. Næstede skemaer
  8. Valgfrie felter med nullable
  9. Validering på klientsiden
  10. Vigtige pointer

Strukturerede outputs i JavaScript

Hvis du udvikler i JavaScript eller TypeScript, er Zod modstykket til Pydantic. Dette bibliotek til validering af skemaer integreres problemfrit med Grok API’en for at producere typede, strukturerede outputs.

Installation

npm install zod openai

OpenAI SDK’et til JavaScript fungerer direkte med Grok API’en – du skal blot pege det på det korrekte endpoint.

Klientkonfiguration

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "your-xai-key",
  baseURL: "https://api.x.ai/v1"
});

Definition af et skema med Zod

Zod bruger et flydende API (fluent API) til at definere skemaer. Hver metode svarer til en JSON-type:

import { z } from "zod";

const MovieReview = z.object({
  title: z.string(),
  rating: z.number(),
  summary: z.string(),
  recommend: z.boolean()
});

Typemapping

ZodJSON-skemaPydantic (Python)
z.string()"type": "string"str
z.number()"type": "number"float
z.boolean()"type": "boolean"bool
z.array(z.string())array af strengelist[str]
z.object({...})"type": "object"BaseModel
z.enum([...])enumLiteral[...]
z.union([...])anyOfUnion-typer
z.nullable()anyOf med nullstr | None

Komplet eksempel

import OpenAI from "openai";
import { z } from "zod";

const client = new OpenAI({
  apiKey: "your-xai-key",
  baseURL: "https://api.x.ai/v1"
});

const Analyse = z.object({
  titre: z.string(),
  resume: z.string(),
  sentiment: z.enum(["positif", "negatif", "neutre"]),
  score: z.number(),
  mots_cles: z.array(z.string()),
  recommandation: z.boolean()
});

const response = await client.chat.completions.create({
  model: "grok-4.20-0309-reasoning",
  messages: [{
    role: "user",
    content: "Analyze the following text: Sales increased by 25% this quarter."
  }],
  response_format: {
    type: "json_schema",
    json_schema: {
      name: "analyse",
      schema: Analyse
    }
  }
});

const data = JSON.parse(response.choices[0].message.content);
console.log(data.sentiment);  // "positive"
console.log(data.score);      // 0.92

Næstede skemaer

Ligesom Pydantic håndterer Zod næstning naturligt:

const Adresse = z.object({
  rue: z.string(),
  ville: z.string(),
  code_postal: z.string(),
  pays: z.string()
});

const Contact = z.object({
  nom: z.string(),
  email: z.string(),
  telephone: z.string().nullable(),
  adresse: Adresse,
  tags: z.array(z.string())
});

Valgfrie felter med nullable

For at gøre et felt valgfrit (så det kan være null), bruger du .nullable():

const Produit = z.object({
  nom: z.string(),
  prix: z.number(),
  description: z.string().nullable(),
  promotion: z.number().nullable()
});

Validering på klientsiden

En fordel ved Zod er, at du kan validere data på klientsiden ved hjælp af samme skema:

const rawData = JSON.parse(response.choices[0].message.content);

// Validering med Zod
const result = Analyse.safeParse(rawData);

if (result.success) {
  console.log(result.data.titre);
} else {
  console.error("Valideringsfejl:", result.error);
}

I praksis vil valideringen altid lykkes, fordi API’en garanterer overholdelse af skemaet. Dette ekstra lag er dog nyttigt for at sikre robusthed i produktion.

Vigtige pointer

  • Zod er JavaScript/TypeScript-modstykket til Pydantic
  • Syntaksen er flydende: z.string(), z.number(), z.object({...})
  • .nullable() gør et felt valgfrit (kan være null)
  • Send Zod-skemaer i response_format.json_schema.schema
  • safeParse() muliggør defensiv validering på klientsiden
  • OpenAI SDK’et til JavaScript fungerer direkte med Grok API’en