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',
    'rich@boop.com',
    '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('rich@boop.com'),
})

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