Realm.collection

O número de valores na collection.

Se null é um valor válido para a coleção.

O tipo de valores na collection.

Adicione um ouvinte callback que será chamado quando uma instância de collection ativa for alterada.

Parâmetros:

• chamada de resposta
• Tipo: function

• Uma função a ser chamada quando ocorrem alterações. A função de chamada de resposta é chamada com dois argumentos:

  • collection: a instância da collection que mudou,
  • changes: um dicionário com chaves insertions , newModifications , oldModifications e deletions , cada um contendo uma lista de índices na coleção que foram inseridos, atualizados ou excluídos respectivamente. deletions e oldModifications são índices da coleção antes da alteração acontecer, enquanto insertions e newModifications são índices da nova versão da coleção.

Lança:

wines.addListener((collection, changes) => {
 // collection === wines
 console.log(`${changes.insertions.length} insertions`);
 console.log(`${changes.modifications.length} modifications`);
 console.log(`${changes.deletions.length} deletions`);
 console.log(`new size of collection: ${collection.length}`);
});

Calcula a média dos valores na collection ou da propriedade fornecida entre todos os objetos na collection, ou undefined se a collection estiver vazia.

Suportado apenas para propriedades int, float e double. Os valores de null são totalmente ignorados por este método e não serão contabilizados na média.

Parâmetros:

• propriedade opcional
• Tipo: string

• Para uma collection de objeto, a propriedade para obter a média de.

Lança:

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Se esta função retornar true para cada objeto, este método retornará true. Esta função usa três argumentos:

  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• esteArg opcional
• Tipo: object

• O valor de this quando callback é chamado.

Retorna novos resultados que representam essa coleção sendo filtrada pela consulta fornecida.

Parâmetros:

• Query
• Tipo: string

• Query usada para filtrar objetos da collection.

• arg opcional repetível
• Tipo: any

• Cada argumento subsequente é usado pelos espaços reservados (por exemplo $0, $1, $2, ...) na query.

Lança:

let merlots = wines.filtered('variety == "Merlot" && vintage 

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Se esta função retornar true, esse objeto será retornado por este método. Esta função usa três argumentos:

  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• esteArg opcional
• Tipo: object

• O valor de this quando callback é chamado.

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Se esta função retornar true, o índice deste objeto será retornado por este método. Esta função usa três argumentos:

  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• esteArg opcional
• Tipo: object

• O valor de this quando callback é chamado.

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Esta função usa três argumentos:

  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• esteArg opcional
• Tipo: object

• O valor de this quando callback é chamado.

Encontra o índice do objeto fornecido na collection.

Parâmetros:

• objeto
• Tipo: T

• O valor a pesquisar na collection.

Lança:

Verifica se esta collection está vazia.

Verifica se a collection não foi excluída e faz parte de um Realm válido.

Une todos os objetos da collection em uma string.

Parâmetros:

• separador opcional
• Tipo: string
• Padrão: ","

• Uma string para separar os valores de retorno do método toString() que está sendo chamado em cada objeto da collection.

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Esta função usa três argumentos:

  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• esteArg opcional
• Tipo: object

• O valor de this quando callback é chamado.

Retorna o valor máximo dos valores na collection ou da propriedade fornecida entre todos os objetos na collection, ou undefined se a collection estiver vazia.

Suportado apenas para propriedades int, float, double e data. Os valores null são totalmente ignorados por este método e não serão retornados.

Parâmetros:

• propriedade opcional
• Tipo: string

• Para uma coleção de objetos, a propriedade para obter o máximo de.

Lança:

Retorna o valor mínimo dos valores na collection ou da propriedade fornecida entre todos os objetos na collection, ou undefined se a collection estiver vazia.

Suportado apenas para propriedades int, float, double e data. Os valores null são totalmente ignorados por este método e não serão retornados.

Parâmetros:

• propriedade opcional
• Tipo: string

• Para uma coleção de objetos, a propriedade para usar o mínimo de.

Lança:

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Esta função usa quatro argumentos:

  • previousValue – O valor retornado anteriormente na última invocação da chamada de resposta, ou initialValue, se fornecido.
  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• initialValue opcional
• Tipo: object

• O valor a ser usado como primeiro argumento para a primeira chamada do callback.

Lança:

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto, da direita para a esquerda, na collection. Esta função usa quatro argumentos:

  • previousValue – O valor retornado anteriormente na última invocação da chamada de resposta, ou initialValue, se fornecido.
  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• initialValue opcional
• Tipo: object

• O valor a ser usado como primeiro argumento para a primeira chamada do callback.

Lança:

Remova todos os ouvintes callback da instância de coleção.

Remova o ouvinte callback da instância da collection.

Parâmetros:

• chamada de resposta
• Tipo: function

• chamada de resposta que foi adicionada anteriormente como um ouvinte através do método addListener .

Lança:

Parâmetros:

• iniciar opcional
• Tipo: number
• Padrão: 0

• O índice inicial. Se negativo, o índice inicial será contado a partir do final da coleta.

• end opcional
• Tipo: number

• O índice final. Os objetos até o índice final, mas não incluindo, serão incluídos no valor de retorno. Se negativo, o índice final será contado a partir do final da collection. Se omitido, todos os objetos do índice inicial serão incluídos no valor de retorno.

Crie um snapshot da collection.

Os valores adicionados e removidos da coleção original não serão refletidos nos resultados retornados por este método, inclusive se os valores das propriedades forem alterados para fazer com que correspondam ou não aos filtros aplicados.

Este não é um snapshot detalhado. Os objetos de Realm contidos neste snapshot continuarão a ser atualizados à medida que as alterações forem feitas neles e, se forem excluídos do Realm, serão substituídos por null nos respectivos índices.

Lança:

Parâmetros:

• chamada de resposta
• Tipo: function

• Função a ser executada em cada objeto da collection. Se esta função retornar true , este método retornará true . Esta função usa três argumentos:

  • object – O objeto atual que está sendo processado na collection.
  • index – O índice do objeto que está sendo processado na collection.
  • collection – A coleção em si.

• esteArg opcional
• Tipo: object

• O valor de this quando callback é chamado.

Retorna novos resultados que representam uma visualização ordenada desta collection.

Uma coleção de Objetos de Realm pode ser classificada em uma ou mais propriedades desses objetos, ou de propriedades de objetos vinculados por esses objetos. Para ordenar por uma única propriedade, basta passar o nome dessa propriedade para sorted(), opcionalmente seguido por um booleano indicando se a classificação deve ser revertida. Para mais de uma propriedade, você deve passar uma array de descritores de classificação que listam quais propriedades classificar.

Collection de outros tipos classificam nos próprios valores, em vez de propriedade dos valores, e, portanto, nenhum nome de propriedade ou descritores de classificação deve ser fornecido.

Parâmetros:

• descritor opcional
• Tipo: string ou [SortDescriptor, ...]

• O(s) nome(s) da propriedade(s) para classificar a coleção.

• reverter opcional
• Tipo: boolean
• Padrão: false

• Classifique em ordem decrescente em vez de ascendente. Não pode ser fornecido se descriptor for uma array de descritores de classificação.

Lança:

// Sort wines by age
wines.sorted('age')

// Sort wines by price in descending order, then sort ties by age in
// ascending order
wines.sorted([['price', false], ['age']])

// Sort a list of numbers in ascending order
let sortedPrices = wine.pricesSeen.sort()

// Sort people by how expensive their favorite wine is
people.sort("favoriteWine.price")

Calcula a soma dos valores na collection ou da propriedade fornecida entre todos os objetos na collection, ou 0 se a collection estiver vazia.

Suportado apenas para propriedades int, float e double. Os valores null são totalmente ignorados por este método.

Parâmetros:

• propriedade opcional
• Tipo: string

• Para uma coleção de objetos, a propriedade para obter a soma.

Lança:

Este é o mesmo método que o método values() . Sua presença torna as collection iteráveis, portanto, podem ser usadas com loops ES6 for-of , operadores de dispersão ... e muito mais.

for (let object of collection) {
  // do something with each object
}

Este é um iterador ES6.

propriedades:

• próximo
• Tipo: function

• Retorna um objeto com duas propriedades:

  • done – true se o iterador tiver terminado de iterar pelos itens da collection, caso contrário false
  • value – o próximo item sendo iterado na collection ou undefined quando done for true

• Símbolo.itizer
• Tipo: function

• Esse método simplesmente retorna this, tornando o próprio iterável iterável (ou seja, utilizável em loops for-of , com o operador de distribuição ... e muito mais).

Um descritor de classificação é uma string contendo um ou mais nomes de propriedades separados por pontos ou uma array com dois itens: [propertyName, reverse].