Skip to content

Model.findOne ​

Chame User.findOne(filter) em um model importado. O método usa os mesmos campos e operadores de filtro de findMany, vincula cada valor como parâmetro e verifica a consulta gerada contra o snapshot local do schema SQLite.

O tipo de retorno é Promise<Result<Optional<User, void>, DbError>>. Aguarde a chamada para receber o Result, que carrega erros do banco. Em caso de sucesso, o Optional interno contém o registro correspondente ou fica ausente quando nenhum registro corresponde. Faça narrowing com if (user) ou forneça um valor alternativo com ??.

A consulta usa LIMIT 1. Quando o filtro pode corresponder a várias linhas, a linha selecionada não é determinística, a menos que o filtro identifique uma linha única, por exemplo, usando @id ou @unique.

Este fragmento pressupõe que User é uma interface @model importada com um campo email.

tyrus
import { DbError } from "tyrus:db";
import { User } from "./models/User";

async function findUser(): Promise<Result<Optional<User, void>, DbError>> {
    const data = await User.findOne({ id: 1 }) onfail {
        return Err(data);
    };
    return Ok(data);
}

Use findMany quando o resultado deve ser uma lista, inclusive no caso de lista vazia. Falhas do banco continuam sendo valores DbError recuperáveis dentro do Result recebido após o await.