Zod v4 chega com performance turbinada

Performance Turbinada na v4

• Compilação TypeScript (tsc): Houve uma redução drástica no número de "instanciações de tipo" que o Zod provoca, resultando em tempos de compilação do tsc significativamente mais rápidos em projetos grandes e com schemas complexos. Em alguns benchmarks, a compilação ficou até 10 vezes mais rápida.

• Performance em Runtime: A validação de dados em tempo de execução também recebeu otimizações profundas. Benchmarks mostram validações de strings, arrays e objetos ficando múltiplas vezes mais rápidas em comparação com a v3.

Zod Mini: Leveza essencial

// Importando a versão mini
import { z } from 'zod/mini';

// No Zod Mini, algumas utilidades são funções diretas
const optionalString = z.optional(z.string());
const unionSchema = z.union([z.string(), z.number()]);

const userSchemaMini = z.object({
  id: z.string(),
  name: z.string().min(3), // Métodos de validação básica como .min() ainda funcionam
  age: z.number().int().positive(),
});

// A sintaxe de parse e safeParse é a mesma
try {
  const validUser = userSchemaMini.parse({ id: 'abc-123', name: 'Pedro', age: 30 });
  console.log('Dados de usuário válidos (Mini):', validUser);
} catch (error) {
  console.error('Erro de validação com Zod Mini:', error);
}

Metadados: enriquecendo seus esquemas

import { z } from 'zod';

const productSchema = z.object({
  id: z.string().meta({ description: 'Identificador único do produto' }),
  name: z.string().meta({ formLabel: 'Nome do Produto' }),
  price: z.number().positive().meta({ unit: 'BRL' }),
});

// Acessando metadados (depende de como outras bibliotecas os utilizam)
console.log(productSchema.shape.id.meta().description); // Saída: Identificador único do produto

Integração nativa com JSON Schema

import { z } from 'zod';

const eventSchema = z.object({
  name: z.string(),
  date: z.string().datetime(),
  location: z.string().optional(),
});

const eventJsonSchema = eventSchema.toJsonSchema();

console.log(JSON.stringify(eventJsonSchema, null, 2));
/* Saída:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "format": "date-time"
    },
    "location": {
      "type": "string"
    }
  },
  "required": [
    "name",
    "date"
  ],
  "$ref": "#/definitions/Event"
}
*/

API local para internacionalização

import { z } from 'zod';
// Importando locales embutidos (disponíveis no pacote @zod/core/locales)
// import { pt } from '@zod/core/locales'; // Exemplo: locale para português

// Configurando um mapa de erro customizado, potencialmente baseado no locale
const customErrorMap: z.ZodErrorMap = (issue, ctx) => {
  // Lógica para retornar a mensagem de erro baseada no issue.code, issue.path,
  // issue.minimum, issue.maximum, issue.expected, issue.received, etc.
  // O objeto ctx contém informações úteis, incluindo ctx.data (se passado no parse)
  // e ctx.defaultError (a mensagem de erro padrão do Zod).

  // Exemplo simplificado (melhor usar um objeto de mensagens separado):
  if (issue.code === z.ZodIssueCode.too_small && issue.type === 'string') {
    return { message: `O campo deve ter no mínimo ${issue.minimum} caracteres.` };
  }
  if (issue.code === z.ZodIssueCode.invalid_string && issue.validation === 'email') {
      return { message: 'Formato de e-mail inválido.' };
  }


  return { message: ctx.defaultError }; // Retorna o erro padrão se não tratado
};

// Configurando o mapa de erro globalmente (abordagem da v4 docs)
z.config({
    errorMap: customErrorMap,
    // locale: pt // Opcional: configurar um locale global se importado
});


const formSchema = z.object({
  email: z.string().email(),
  password: z.string().min(8),
});

const formData = { email: 'invalido@', password: 'curta' };

try {
  // O mapa de erro configurado globalmente será usado
  formSchema.parse(formData);
} catch (error: any) {
  console.log('Erros de validação localizados:');
  error.errors.forEach((err: any) => console.log(`- ${err.message}`));
}
/* Saída (exemplo baseado no mapa de erro customizado):
Erros de validação localizados:
- Formato de e-mail inválido.
- O campo deve ter no mínimo 8 caracteres.
*/

Comparativo: Zod v4 vs. versões anteriores

A v4 não apenas otimiza o que já existia, mas também adiciona camadas significativas de funcionalidade e flexibilidade, tornando o Zod uma escolha ainda mais atraente para projetos de todos os tamanhos e complexidades.

Olhando para o futuro: a iniciativa Standard Skema

Conclusão

Perguntas Frequentes sobre o Zod v4