NOVIDADES

Novidades no 5.6

A versão v5.6 do driver Node.js inclui as seguintes funcionalidades:

• O driver agora suporta o Node.js v20.

• O driver pode retornar um cursor como resposta a um comando de servidor quando você chama o método runCursorCommand() . Para saber mais sobre esse recurso, consulte a Documentação da API runCursorCommand.

• Suporte para especificar opções de criação da coleção de séries temporais bucketMaxSpanSeconds e bucketRoundingSeconds. Para saber mais sobre essas opções de coleção de séries temporais, consulte Como definir granularidade para dados de séries temporais no manual do servidor.

Para saber mais sobre esta versão, consulte Destaques da versão v5.6.0.

5.5: quais as novidades

As novas funcionalidades da versão do driver do 5.5 Node.js incluem:

• O driver agora detecta com precisão ambientes de Função como Serviço (FaaS) na AWS, considerando as variáveis de ambiente da AWS somente se elas começarem com AWS_Lambda_.

• Você deve atualizar o mongodb-client-encryption para a versão 2.8.0 ou posterior para criar uma collection criptografada usando a funcionalidade Queryable Encryption.

5.4: quais as novidades

As novas funcionalidades da versão do driver do 5.4 Node.js incluem:

• O método ChangeStream.tryNext agora utiliza o tipo genérico do TChange específico do esquema em vez da interface do Document.

Para saber mais, consulte os destaques da versão v5.4.0.

O que há de novo em 5.3

As novas funcionalidades da versão do driver do 5.3 Node.js incluem:

• Os metadados do cliente agora incluem informações sobre o ambiente de função como serviço (FaaS) e detecção de tempo de execução alternativo.

• O driver permite agora endereços de registo SRV que contêm um ponto à direita.

• UpdateResult.upsertedId agora retorna nulo quando nenhum documento é atualizado.

Para saber mais, consulte os destaques da versão v5.3.0.

Novidades no 5.2

As novas funcionalidades da versão 5.2 do driver Node.js incluem:

• O driver agora oferece suporte à obtenção automática de credenciais do Azure ao usar a Queryable Encryption automática.

Para saber mais, consulte os destaques da versão v5.2.0.

Novidades no 5.1

As novas funcionalidades da versão do driver do 5.1 Node.js incluem:

• O driver agora suporta serialização automática do JavaScript bigint para BSON.Long. Ele também suporta a desserialização de valores do BSON.Long retornados do servidor para valores do bigint quando o sinalizador useBigInt64 é passado como verdadeiro.

Para saber mais, consulte os destaques da versão v5.1.0.

Novidades no 5.0

As novas funcionalidades da versão 5.0 do driver Node.js incluem:

• Por padrão, o driver não verifica mais os tipos referenciados em notação de ponto, a menos que a anotação de tipo StrictFilter seja explicitamente usada. Para saber mais sobre essa mudança, consulte a página de fundamentos do Typescript.

  Observação

  Esta alteração é apenas para Typescript e não afeta queries ou operações no tempo de execução.

• Instalação opcional do @aws-sdk/credential-providers como uma dependência de emparelhamento.

  • O driver já não inclui módulos do AWS SDK por padrão. Use o seguinte comando npm para instalar o SDK:

    npm install --save "@aws-sdk/credential-providers@^3.201.0"

    Se instalar o SDK, o npm notificará você se a versão do SDK que instalou for incompatível com o driver. Depois de instalar a dependência corretamente, o driver usa o próprio AWS SDK para gerenciar credenciais do ambiente.

O que há de novo em 4.17

As novas funcionalidades da versão do driver Node.js 4.17 incluem:

• Adiciona o pacote mongodb-js/saslprep como dependência do driver.

• Melhora a compatibilidade com a funcionalidade Queryable Encryption.

Para saber mais, consulte os destaques da versão v4.17.0.

Novidades no 4.16

As novas funcionalidades da versão do driver Node.js 4.16 incluem:

• Inclui informações da plataforma Function-as-a-Service (FaaS) nos metadados do handshake do driver.

• Identifica o uso de tempo de execução do Deno nos metadados do cliente.

Para saber mais, consulte os destaques da versão v4.16.0.

4.15: quais as novidades

As novas funcionalidades da versão do driver Node.js 4.15 incluem:

• Suporte para roles do AWS IAM para contas de serviço.

Para saber mais, consulte os destaques da versão v4.15.0.

O que há de novo em 4.14

As novas funcionalidades da versão do driver do 4.14 Node.js incluem:

• Corrigido um vazamento de memória introduzido na v4.13.

• Métodos e opções obsoletos que referenciam o Logger legado.

4.13: quais as novidades

As novas funcionalidades da versão do driver do 4.13 Node.js incluem:

• Cancelamento automático de operações a bordo no pool de conexões quando o driver encontra erros de tempo limite de rede.

• Desativou a consistência causal em sessões implícitas para evitar conflitos com as configurações de read concern linearizable e available.

• Corrigido um possível vazamento de memória, garantindo que o driver destrua instâncias de MessageStream sempre que suas conexões forem destruídas.

4.12: quais as novidades

As novas funcionalidades da versão do driver do 4.12 Node.js incluem:

• Redefinição da classe ChangeStream como uma iteração assíncrona. Você pode usar instâncias do ChangeStream em qualquer contexto que espere um AsyncIterator.

  • Em especial, os change streams agora podem ser usados em loops do Javascript for-await:

    const changeStream = myColl.watch();
    for await (const change of changeStream) {
      console.log("Received change: ", change);
    }

• Correção no monitoramento do servidor quando o driver ignora eventos de monitoramento. Nesta versão, o driver sempre atualiza sua exibição da topologia ao processar eventos de monitoramento.

• Melhorias no desempenho com o armazenamento em buffer como resultado da modificação das estruturas de dados usadas internamente no driver.

Para saber mais, consulte os destaques da versão v4.12.0.

Novidades no 4.11

interface Author {
    name: string;
    bestBook: Book;
}
interface Book {
    title: string;
    author: Author;
 }

myColl.findOne({ 'bestBook.author.bestBook.title': 25 });

myColl.findOne({
    'bestBook.author.bestBook.author.bestBook.author.bestBook.author.bestBook.author.name': 25
});

Novidades no 4.10

As novas funcionalidades da versão do driver do 4.10 Node.js incluem:

• Descontinuação da chamada de resposta

  • Chamadas de resposta agora estão obsoletas em favor de Promises. As chamadas de resposta serão removidas no próximo lançamento principal. A equipe de drivers do Node recomenda migrar para Promises sempre que possível:

    • Use a sintaxe async/await.

    • Use o utilitário callbackify do Node.js:

      require('util').callbackify(() => myColl.findOne())(callback)

    • Use a sintaxe em seguida:

      myColl.findOne().then(res => callback(null, res), err => callback(err))

  • Se não for possível migrar para o Promises em uma base de código grande, você pode usar o driver do Node.js legado com suporte opcional de chamada de resposta.

Para saber mais, consulte v4.10.0 Destaques da versão.

Novidades no 4.9

As novas funcionalidades da versão 4.9 do driver Node.js incluem:

• Correção de uma inconsistência com as opções writeConcern nas definições de tipo.

• Incluída a versão mais recente do BSON, que adiciona suporte automático a UUID. Consulte as notas de versão do BSON aqui.

Para saber mais, consulte v4.9.0 Destaques da versão.

4.8: quais as novidades

As novas funcionalidades da versão 4.8 do driver Node.js incluem:

• Adicionado preenchimento automático e segurança de tipo para chaves aninhadas em um filtro de atualização

• client.startSession() agora pode ser chamado antes de se conectar ao MongoDB

• estimatedDocumentCount() método agora pode aceitar um comentário

Para saber mais, consulte v4.8.0 Destaques da versão.

O que há de novo em 4.7

As novas funcionalidades da versão 4.7 do driver Node.js incluem:

• O método MongoClient.connect() agora é opcional ao conectar-se à sua instância do MongoDB

• Capacidade de comprimir mensagens com o algoritmo de compressão Zstandard

• Suporte para a opção de conexão maxConnecting

• Capacidade dos documentos de change stream mostrarem seus documentos antes e depois de uma atualização

• Adicionado suporte para novos campos de change streams relacionados à replicação de cluster para cluster

• O método estimatedDocumentCount() agora utiliza o comando de banco de dados $count

• Aprimoramento da conexão com o MongoDB na fase de AWS Lambda Init

4.6: quais as novidades

As novas funcionalidades da versão do driver Node.js 4.6 incluem:

• Melhorou o ChangeStreamDocument no TypeScript.

• Distribuição uniforme da seleção de servidores com base na carga entre servidores.

Para saber mais, consulte v4.6.0 Destaques da versão.

Novidades no 4.5

Consulte Destaques da versão v4.5.0 no GitHub.

O que há de novo em 4.4

As novas funcionalidades da versão do driver do 4.4 Node.js incluem:

• Suporte do provedor KMIP ao usar CSFLE.

• Suporte a TLS durante o uso de CSFLE.

• A canonicalização de nome de host agora aceita "none", "forward" e "forwardAndReverse" como authMechanismProperties ao utilizar GSSAPI.

• Na versão 4.0.0 do driver, o método collection.count() obsoleto foi alterado inadvertidamente para se comportar como collection.countDocuments(). Nesta versão, o método collection.count() foi atualizado para corresponder ao comportamento legado:

  • Se uma query for fornecida, collection.count() se comportará da mesma forma que collection.countDocuments() e executará uma verificação de collection.

  • Se nenhuma query for fornecida, collection.count() se comportará da mesma forma que collection.estimatedDocumentCount() e dependerá dos metadados da collection.

  Importante

  Aviso de depreciação

  O método cursor.count() está obsoleto e será removido na próxima versão principal, junto com collection.count(). Use os métodos collection.estimatedDocumentCount() ou collection.countDocuments().

Novidades no 4.3

As novas funcionalidades da versão 4.3 do driver Node.js incluem:

• Suporte a SOCKS5

• Opção para desativar a validação UTF-8

• Tipo de inferência para documentos aninhados

4.2: quais as novidades

As novas funcionalidades da versão do driver do 4.2 Node.js incluem:

• srvMaxHosts e srvServiceName opções de conexão de lista de sementes DNS

Novidades no 4.1

As novas funcionalidades da versão do driver do 4.1 Node.js incluem:

• Adicionado suporte de conexão balanceada de carga para todos os tipos de cluster, incluindo a plataforma sem servidor beta.

• Suporte adicionado para o método advanceClusterTime() para determinar se o ClientSession deve atualizar seu tempo de cluster.

4.0: quais as novidades

As novas funcionalidades da versão do driver do 4.0 Node.js incluem:

const fc = myColl.find({a: 2.3}).skip(1)
for await (const doc of fc) {
  console.log(doc)
  fc.limit(1) // incorrect usage, cursor already executing
}

const cursor = myColl.find({});
const stream = cursor.stream();
stream.on("data", data => console.log);
stream.on("error", () => client.close());

const collections = (await db.listCollections({}, { nameOnly: true })
  .toArray()).map(
    ({name}) => name
  );
if (!collections.includes(myNewCollectionName)) {
  throw new Error(`${myNewCollectionName} doesn't exist`);
}

// old way
const gs = new GridStore(db, filename, mode[, options])
// new way
const bucket = new GridFSBucket(client.db('test')[,options])

bucket.openDownloadStreamByName(filename, { start: 0, end: 100 })

await client.connect();
const filename = 'test.txt'; // whatever local file name you want
const db = client.db();
const bucket = new GridFSBucket(db);
fs.createReadStream(filename)
  .pipe(bucket.openUploadStream(filename))
  .on('error', console.error)
  .on('finish', () => {
    console.log('done writing to db!');
    bucket
      .find()
      .toArray()
      .then(files => {
        console.log(files);
        bucket
          .openDownloadStreamByName(filename)
          .pipe(fs.createWriteStream('downloaded_' + filename))
          .on('error', console.error)
          .on('finish', () => {
            console.log('done downloading!');
            client.close();
          });
      });
  });

// old way
GridStore.unlink(db, name, callback);
// new way
bucket.delete(file_id);

const fileMetaDataList: GridFSFile[] = bucket.find({}).toArray();

Novidades no 3.7

As novas funcionalidades da versão 3.7 do driver Node.js incluem:

• Suporte adicionado para o modo balanceador de carga ao habilitar a opção useUnifiedTopology

• Suporte adicionado para API estável e a habilitação da opção useUnifiedTopology

O que há de novo em 3.6

As novas funcionalidades da versão do driver do 3.6 Node.js incluem:

• Foi adicionado suporte ao mecanismo de autenticação MONGODB-AWS usando as credenciais do Amazon Web Services (AWS) Identity e Access Management (IAM)

• O método find() suporta allowDiskUse() para classificações que exigem muita memória para serem executadas na RAM

• Os métodos update() e replaceOne() são compatíveis com dicas de índices

• Redução no tempo de recuperação para alterações de topologia e eventos de failover

• Melhorias no teste de validação para o writeConcern padrão

• A autenticação exige menos viagens de ida e volta para o servidor, resultando em uma configuração de conexão mais rápida

• Conversas mais curtas do Salted Challenge Response Authentication Mechanism (SCRAM)

• Capacidade de criar collections e índices para múltiplas transações de documentos

• Executando validação para uma collection em segundo plano