O Realm reconhecimento de data center.

Construtores

  • Crie uma nova Instância de Realm, no caminho padrão.

    Retorna Realm

    Lança

    Um erro quando um Realm sincronizado incompatível é aberto.

  • Crie uma nova Instância de Realm no caminho fornecido.

    Parâmetros

    • caminho: string

      Obrigatório ao criar o Realm pela primeira vez.

    Retorna Realm

    Lança

    Um erro se o Realm não puder ser aberto no caminho fornecido.

    Lança

    Um erro quando um Realm sincronizado incompatível é aberto.

  • Crie uma nova Instância de Realm usando a configuração fornecida. Se um Realm ainda não existir em config.path (ou Realm.defaultPath se não for fornecido), esse construtor o criará com o config.schema fornecido (que é necessário nesse caso). Caso contrário, a instância acessará o Realm existente do arquivo nesse caminho. Nesse caso, config.schema é opcional ou não foi alterado, a menos que config.schemaVersion seja incrementado, caso em que o Realm será migrado automaticamente para usar o novo esquema. No caso da sincronização baseada em query, o config.schema é necessário. Uma exceção será lançada se config.schema não estiver definido.

    Parâmetros

    • config: configuração

      Obrigatório ao criar o Realm pela primeira vez.

    Retorna Realm

    Lança

    Um erro se algo na configuração fornecida for inválido.

    Lança

    Um erro quando um Realm sincronizado incompatível é aberto.

Propriedades

sessãode sincronização: zero | Sessão

A sessão de sincronização, se este for um Realm sincronizado

caminhopadrão: string

Acessores

  • get isClosed(): booleano
  • Indica se este Realm foi fechado.

    Retorna booleano

    true se fechado, false caso contrário.

    desde

    2.1.0

  • get isEmpty(): booleano
  • Indica se este Realm contém algum objeto.

    Retorna booleano

    true se vazio, false caso contrário.

    desde

    1.10.0

  • get isInMemory(): booleano
  • Indica se este Realm foi aberto na memória.

    Retorna booleano

    true se este Realm estiver na memória, caso contrário false .

  • get isInMigration(): booleano
  • Indica se este Realm está em migração.

    Retorna booleano

    true se estiver migrando, caso contrário false

    desde

    12.3.0

  • get isInTransaction(): booleano
  • Indica se este Realm está em uma transação de escrita.

    Retorna booleano

    true se em uma transação de escrita, false caso contrário.

    desde

    1.10.3

  • get isReadOnly(): booleano
  • Indica se este Realm foi aberto como somente leitura.

    Retorna booleano

    true se este Realm for somente leitura, false caso contrário.

    desde

    0.12.0

  • obter caminho(): string
  • O caminho para o arquivo onde este Realm está armazenado.

    Retorna a string

    Uma string contendo o caminho para o arquivo onde este Realm está armazenado.

    desde

    0.12.0

  • get schemaVersion(): número
  • A versão atual do esquema do Realm.

    Retorna número

    A versão do esquema deste Realm, como um number.

    desde

    0.12.0

  • obter assinaturas(): SubscriptionSet
  • O conjunto mais recente de assinaturas de Flexible Sync.

    Retorna o conjunto de assinaturas

    Um objeto SubscriptionSet .

    Lança

    Um erro se a Flexible Sync não estiver habilitada para esse aplicativo.

Métodos

  • Parâmetros de tipo

    • t estende Objeto<Objeto padrão, nunca, t>

    Parâmetros

    • tipo: Construtor<T>
    • objectKey: string

    Retorna indefinido | T

  • Adicione uma chamada de resposta de ouvinte para o eventName especificado.

    Parâmetros

    • eventName: RealmEventName

      O nome do evento que deve fazer com que a chamada de resposta seja chamada.

    • chamada de resposta: RealmListenerCallback

      Função a ser chamada quando ocorre um evento de alteração. Cada chamada de resposta só será chamada uma vez por evento, independentemente do número de vezes que foi adicionada.

    Retorna nulo

    Lança

    Um erro se um evento inválido eventName for fornecido, se o Realm estiver fechado ou se a chamada de resposta não for uma função.

  • Inicie uma transação de escrita.

    Ao fazer uma transação, é altamente recomendável fazer o tratamento de erros. Se você não lidar com erros, seus dados podem se tornar inconsistentes. O tratamento de erros geralmente envolve o cancelamento da transação.

    Retorna nulo

    Lança

    Um erro se já estiver na transação de escrita

    Veja

    Exemplo

    realm.beginTransaction();
    try {
    realm.create('Person', { name: 'Arthur Dent', origin: 'Earth' });
    realm.create('Person', { name: 'Ford Prefect', origin: 'Betelgeuse Five' });
    realm.commitTransaction();
    } catch (e) {
    realm.cancelTransaction();
    throw e;
    }
  • Cancelar uma transação de escrita.

    Retorna nulo

  • Fecha este Realm para que ele possa ser reaberto com uma versão mais recente do esquema. Todos os objetos e coleções deste Realm não são mais válidos após chamar este método. O método é idempotente.

    Retorna nulo

  • Confirme uma transação de escrita.

    Retorna nulo

  • Substitui todas as colunas de cadeia de caracteres neste Realm por uma coluna de enumeração de cadeia de caracteres e compacta o arquivo de reconhecimento de data center.

    Não pode ser chamado de uma transação de escrita.

    A compactação não ocorrerá se existirem outras Instância de Realm .

    Enquanto a compactação estiver em andamento, as tentativas de outros threads ou processos de abrir o reconhecimento de data center aguardarão.

    Esteja avisado que os requisitos de recursos para compactação são proporcionais à quantidade de dados em tempo real no banco de dados. A compactação grava o conteúdo do banco de dados em um arquivo de banco de dados temporário e, em seguida, substitui o banco de dados pelo temporário.

    Retorna booleano

    true se a compactação for bem-sucedida, false caso contrário.

  • Crie um novo RealmObject do tipo fornecido e com as propriedades especificadas. Para objetos marcados como assimétricos, undefined é retornado. A API para objetos assimétricos está sujeita a alterações futuras.

    Parâmetros de tipo

    • T = DefaultObject

    Parâmetros

    • tipo: corda

      O tipo de objeto de Realm a ser criado.

    • valores: Parcial<T> | Parcial<Não gerenciado<T>>

      Valores de propriedade para todas as propriedades necessárias sem um valor padrão.

    • Optional modo: booleano | Nunca | Modificado | Todos

      Modo de atualização opcional. O padrão é UpdateMode.Never.

    Retorna o objeto<T, nunca> & T

    Um RealmObject ou undefined se o objeto for assimétrico.

  • Parâmetros de tipo

    Parâmetros

    Retorna T

  • Exclui o Objeto de Realm fornecido ou cada um dentro da collection fornecida.

    Parâmetros

    • assunto: qualquer

      O objeto de Realm a ser excluído ou uma coleção contendo vários objetos de Realm a serem excluídos.

    Retorna nulo

  • AVISO: isso excluirá todos os objetos no Realm!

    Retorna nulo

  • Exclui um modelo de Realm, incluindo todos os seus objetos. Se chamado fora de uma função de migração, o esquema e o schemaVersion serão atualizados.

    Parâmetros

    • nome: string

      O nome do modelo.

    Retorna nulo

  • Pesquisar um Objeto de Realm por sua chave primária.

    Parâmetros de tipo

    • T = DefaultObject

    Parâmetros

    • tipo: corda

      O tipo de Objeto de Realm a ser pesquisado.

    • primaryKey: T[chave de T]

      O valor da chave primária do objeto a ser pesquisado.

    Retorna nulo | objeto<T, nunca> & T

    Um RealmObject ou null se nenhum objeto for encontrado.

    Lança

    Um erro será gerado se o tipo passado para esse método for inválido, ou se o tipo de objeto não tiver uma primaryKey especificada no esquema, ou se for marcado como assimétrico.

    desde

    0.14.0

  • Parâmetros de tipo

    Parâmetros

    • tipo: Construtor<T>
    • primaryKey: T[chave de T]

    Retorna nulo | T

  • Retorna todos os objetos do tipo fornecido no Realm.

    Parâmetros de tipo

    • T = DefaultObject

    Parâmetros

    • tipo: corda

      O tipo de Objeto de Realm a serem recuperados.

    Retorna Resultados<objeto<T, nunca> & T>

    Resultados que serão atualizados à medida que os objetos forem criados, modificados e destruídos.

    Lança

    Um erro se o tipo passado para este método for inválido ou se o tipo estiver marcado como incorporado ou assimétrico.

  • Parâmetros de tipo

    • t estende Objeto<any, nunca, t> = Objeto<DefaultObject, nunca> & DefaultObject

    Parâmetros

    • tipo: Construtor<T>

    Retorna resultados<T>

  • Remova todos os ouvintes de eventos (restringidos ao evento eventName, se fornecido).

    Parâmetros

    • Optional eventName: RealmEventName

      O nome do evento cujos ouvintes devem ser removidos.

    Retorna nulo

    Lança

    Um erro quando o evento eventName inválido é fornecido.

  • Remove a chamada de resposta do ouvinte para o evento especificado eventName.

    Parâmetros

    Retorna nulo

    Lança

    um erro se um evento inválido eventName for fornecido, se o realm estiver fechado ou se a chamada de resposta não for uma função.

  • Chame de forma síncrona a chamada de resposta fornecida dentro de uma transação de escrita. Se acontecer uma exceção dentro de uma transação, você perderá as alterações nessa transação, mas o próprio Realm não será afetado (ou corrompido). Mais precisamente, getTransaction e commitTransaction serão chamados automaticamente. Se alguma exceção for lançada durante a transação, cancelTransaction será chamado em vez de commitTransaction e a exceção será lançada novamente para o chamador de write.

    Transação agrupadas (chamando write dentro de write) não são possíveis.

    Parâmetros de tipo

    • t

    Parâmetros

    • chamada de resposta: (() => T)

      Função a ser chamada dentro de uma transação de escrita.

        • (): t
        • Retorna T

    Retorna T

    Valor retornado da chamada de resposta.

  • Escreve uma cópia compactada do Realm com a configuração fornecida.

    O arquivo de destino ainda não pode existir. Todas as conversões entre Realms sincronizados e não sincronizados são suportadas e serão realizadas de acordo com o parâmetro de configuração, que descreve a saída desejada.

    Observe que, se esse método for chamado de dentro de uma transação de gravação, os dados atuais serão gravados, não os dados do ponto em que a transação de escrita anterior foi confirmada.

    Parâmetros

    • config: configuração

      Configuração do Realm que descreve o Realm de saída.

    Retorna nulo

  • Copie quaisquer Arquivo de Realm (ou seja, *.realm) fornecidos com o aplicativo do diretório de aplicativos para o diretório de documentos do aplicativo, para que possam ser abertos e usados pelo Realm. Se o arquivo já existir no diretório de documentos, ele não será substituído, para que possa ser chamado com segurança várias vezes.

    Isso deve ser chamado antes de abrir o Realm, a fim de mover o Arquivo de Realm para um local onde eles podem ser gravados.

    Retorna nulo

    Exemplo

    // Given a bundled file, example.realm, this will copy example.realm (and any other .realm files)
    // from the app bundle into the app's documents directory. If the file already exists, it will
    // not be overwritten, so it is safe to call this every time the app starts.
    Realm.copyBundledRealmFiles();

    const realm = await Realm.open({
    // This will open example.realm from the documents directory, with the bundled data in.
    path: "example.realm"
    });

    Isso só é implementado para o React Native.

    Lança

    um erro se ocorrer um erro de E/S ou se o método não estiver implementado.

  • Cria um objeto de modelo para uma classe de modelo Realm em que todos os campos opcionais são indefinidos e todos os campos obrigatórios têm o valor padrão para o tipo de dados fornecido, o valor definido pela propriedade padrão no esquema ou o valor padrão para o tipo de dados, se o esquema não especifica um, ou seja, 0, falso e "".

    Parâmetros de tipo

    • t estende Registro<string, desconhecido>

    Parâmetros

    • objectSchema: ObjectSchema

      Esquema descrevendo o objeto que deve ser criado.

    Retorna T

  • Exclua o Arquivo de Realm para a configuração fornecida.

    Parâmetros

    • config: configuração

      A configuração do Realm que está sendo excluído.

    Retorna nulo

    Lança

    Um erro se algo na configuração fornecida for inválido.

  • Verifica se o Realm já existe no disco.

    Parâmetros

    • caminho: string

      O caminho para um Realm.

    Retorna booleano

    true se o Realm existir no dispositivo, false caso contrário.

    Lança

    Um erro se algo no caminho fornecido for inválido.

  • Verifica se o Realm já existe no disco.

    Parâmetros

    Retorna booleano

    true se o Realm existir no dispositivo, false caso contrário.

    Lança

    Um erro se algo na configuração fornecida for inválido.

  • Abra o Realm padrão de forma assíncrona com uma promessa.

    Retorna ProgressRealmPromise

    Uma promessa que será resolvida com a Instância de Realm quando estiver disponível.

  • Abra um Realm de forma assíncrona com uma promessa. Se o Realm estiver sincronizado, ele será totalmente sincronizado antes de estar disponível.

    Parâmetros

    • caminho: string

      O caminho para o Realm.

    Retorna ProgressRealmPromise

    Uma promessa que será resolvida com a Instância de Realm quando estiver disponível.

  • Abra um Realm de forma assíncrona com uma promessa. Se o Realm estiver sincronizado, ele será totalmente sincronizado antes de estar disponível. No caso de sincronização baseada em query, Configuration.schema é necessário. Uma exceção será lançada se Configuration.schema não estiver definido.

    Parâmetros

    Retorna ProgressRealmPromise

    Uma promessa que será resolvida com a Instância de Realm quando estiver disponível.

    Lança

    Um erro se algo na configuração fornecida for inválido.

  • Obtenha a versão do esquema atual do Realm no caminho fornecido.

    Parâmetros

    • caminho: string

      O caminho para o arquivo onde o banco de dados do Realm está armazenado.

    • Optional encryptionKey: ArrayBuffer | ArrayBufferView

      Necessário apenas ao acessar Realms criptografados.

    Retorna número

    Versão do esquema como um número inteiro ou -1 se não existir nenhum Realm no caminho.

    Lança

    Um erro ao passar uma chave de criptografia inválida ou não correspondente.

    desde

    0.11.0

  • Define o nível de registro.

    Parâmetros

    • nível: LogLevel

      O nível de registro a ser usado pelo criador de logs. O valor padrão é info.

    • Optional categoria: "Realm" | "Realm.Storage" | "Realm.Storage.Transaction" | "Realm.Storage.Query" | "Realm.Storage.Object" | "Realm.Storage.Notification" | "Realm.Sync" | "Realm.Sync.Client" | "Realm.Sync.Client.Session" | "Realm.Sync.Client.Changeset" | "Realm.Sync.Client.Network" | "Realm.Sync.Client.Reset" | "Realm.Sync.Server" | "Realm.App" | "Realm.SDK"

      A categoria para a qual definir o nível de registro. Se omitido, o nível de registro é definido para todas as categorias ("Realm").

    Retorna nulo

    Observação

    O nível de registro pode ser alterado durante a vida útil do aplicativo.

    desde

    12.0.0

    Exemplo

    Realm.setLogLevel("all");
    
  • Define a chamada de resposta do registrador.

    Parâmetros

    • loggerCallback: LoggerCallback2

      A chamada de resposta invocada pelo criador de logs. A chamada de resposta padrão usa console.log, console.warn e console.error, dependendo do nível da mensagem.

    Retorna nulo

    Observação

    A chamada de resposta do logger precisa ser configurada antes de abrir o primeiro Realm.

    desde

    12.0.0

    Exemplo

    Realm.setLogger(({ category, level, message }) => {
    console.log(`[${category} - ${level}] ${message}`);
    });
  • Define a chamada de resposta do registrador.

    Parâmetros

    • loggerCallback: LoggerCallback1

      A chamada de resposta invocada pelo criador de logs. A chamada de resposta padrão usa console.log, console.warn e console.error, dependendo do nível da mensagem.

    Retorna nulo

    Observação

    A chamada de resposta do logger precisa ser configurada antes de abrir o primeiro Realm.

    desde

    12.0.0

    Obsoleto(a)

    Passe um retorno de chamada usando um único argumento de objeto.

    Exemplo

    Realm.setLogger((level, message) => {
    console.log(`[${level}] ${message}`);
    });
  • Fecha todos os Realms, cancela todas as chamadas Realm.open pendentes, limpa os caches internos, redefine o registrador e coleta lixo. Chame esse método para liberar o loop de eventos e permitir que o Node.js execute uma saída normalmente.

    Retorna nulo

Gerado usando TypeDoc