Prisma 验证器

Prisma.validator 是一个实用工具函数，它接受一个生成的类型，并返回一个类型安全的对象，该对象符合生成的类型模型字段。

本页介绍 Prisma.validator，并提供您可能选择使用它的一些原因。

注意：如果您有 Prisma.validator 的用例，请务必查看这篇关于使用新的 TypeScript satisfies 关键字改进 Prisma Client 工作流程的 博客文章。您很可能可以使用 satisfies 原生解决您的用例，而不是使用 Prisma.validator。

创建类型化的查询语句

假设您创建了一个新的 userEmail 对象，您想在整个应用程序的不同查询中重复使用它。它是类型化的，可以安全地用于查询。

下面的示例要求 Prisma 返回 id 为 3 的用户的 email，如果用户不存在，则返回 null。

import { Prisma } from '@prisma/client'

const userEmail: Prisma.UserSelect = {
  email: true,
}

// Run inside async function
const user = await prisma.user.findUnique({
  where: {
    id: 3,
  },
  select: userEmail,
})

这工作得很好，但是以这种方式提取查询语句有一个注意事项。

您会注意到，如果您将鼠标悬停在 userEmail 上，TypeScript 不会推断对象的键或值（即 email: true）。

如果您在 prisma.user.findUnique(...) 查询中使用 userEmail 上的点表示法，情况也是如此，您将能够访问 select 对象可用的所有属性。

如果您在一个文件中使用它，那可能没问题，但是如果您要导出此对象并在其他查询中使用它，或者如果您正在编译一个外部库，并且您想控制用户如何在他们的查询中使用此对象，那么这将不是类型安全的。

对象 userEmail 已被创建为仅选择用户的 email，但它仍然可以访问所有其他可用属性。它是类型化的，但不是类型安全的。

Prisma 有一种验证生成类型以确保它们是类型安全的方法，即命名空间上可用的实用工具函数 validator。

使用 Prisma.validator

以下示例将 UserSelect 生成类型传递给 Prisma.validator 实用工具函数，并以与前一个示例非常相似的方式定义预期的返回类型。

import { Prisma } from '@prisma/client'

const userEmail: Prisma.UserSelect = {
  email: true,
}

const userEmail = Prisma.validator<Prisma.UserSelect>()({
  email: true,
})

// Run inside async function
const user = await prisma.user.findUnique({
  where: {
    id: 3,
  },
  select: userEmail,
})

或者，您可以使用以下语法，该语法使用“选择器”模式，使用 Prisma Client 的现有实例

import { Prisma } from '@prisma/client'
import prisma from './lib/prisma'

const userEmail = Prisma.validator(
  prisma,
  'user',
  'findUnique',
  'select'
)({
  email: true,
})

最大的区别在于 userEmail 对象现在是类型安全的。如果您将鼠标悬停在其上，TypeScript 会告诉您对象的键/值对。如果您使用点表示法访问对象的属性，您将只能访问对象的 email 属性。

当与用户定义的输入（如表单数据）结合使用时，此功能非常方便。

将 Prisma.validator 与表单输入结合使用

以下示例从 Prisma.validator 创建一个类型安全的函数，该函数可以在与用户创建的数据（例如表单输入）交互时使用。

注意：表单输入在运行时确定，因此仅使用 TypeScript 无法验证。请务必在将数据传递到数据库之前，通过其他方式（例如外部验证库）验证您的表单输入。

import { Prisma, PrismaClient } from '@prisma/client'

const prisma = new PrismaClient()

// Create a new function and pass the parameters onto the validator
const createUserAndPost = (
  name: string,
  email: string,
  postTitle: string,
  profileBio: string
) => {
  return Prisma.validator<Prisma.UserCreateInput>()({
    name,
    email,
    posts: {
      create: {
        title: postTitle,
      },
    },
    profile: {
      create: {
        bio: profileBio,
      },
    },
  })
}

const findSpecificUser = (email: string) => {
  return Prisma.validator<Prisma.UserWhereInput>()({
    email,
  })
}

// Create the user in the database based on form input
// Run inside async function
await prisma.user.create({
  data: createUserAndPost(
    'Rich',
    '[email protected]',
    'Life of Pie',
    'Learning each day'
  ),
})

// Find the specific user based on form input
// Run inside async function
const oneUser = await prisma.user.findUnique({
  where: findSpecificUser('[email protected]'),
})

createUserAndPost 自定义函数是使用 Prisma.validator 创建的，并传递了一个生成的类型 UserCreateInput。 Prisma.validator 验证函数输入，因为分配给参数的类型必须与生成的类型期望的类型匹配。