Menu Docs
Página inicial do Docs
/
Idiomas
/
JavaScript
/
Node.js

Atualizar versões do driver

Nesta página

  • Visão geral
  • Como fazer a atualização
  • Mudanças de última hora
  • Alterações significativas na versão 4.x
  • Alterações na compatibilidade da versão do servidor
  • Versão 4.2: mudanças no suporte à versão do servidor

Visão geral

Nesta página, você pode saber como atualizar seu driver para uma nova versão. Esta página também inclui as alterações que você deve fazer no seu aplicativo para atualizar seu driver sem perder a funcionalidade, se aplicável.

Como fazer a atualização

Antes de atualizar, execute as seguintes ações:

  • Certifique-se de que a nova versão do driver é compatível com a versão do Servidor MongoDB à qual seu aplicativo se conecta e com a versão do Node.js em que o aplicativo é executado. Consulte a página de compatibilidade para ver essas informações.

  • Resolva quaisquer alterações interruptivas entre a versão do driver que seu aplicativo usa atualmente e a versão de atualização planejada na seção alterações interruptivas deste guia. Para saber mais sobre as mudanças de compatibilidade da versão do MongoDB Server, consulte a seção Alterações de compatibilidade da versão do servidor.

Dica

Você pode minimizar a quantidade de alterações que precisa fazer no aplicativo ao atualizar as versões do driver usando a stable API.

Para atualizar sua versão do driver, execute o seguinte comando no diretório do aplicativo:

npm install mongodb@4.17

Para atualizar para outra versão do driver, substitua as informações após o símbolo @ pelo número da versão desejada. Para obter mais informações sobre o npm install comando , consulte o npm-install documentação npm.

Mudanças de última hora

Uma alteração significativa é uma modificação em uma convenção ou comportamento em uma versão específica do driver que pode impedir que seu aplicativo funcione conforme o esperado.

As alterações interruptivas nesta seção são categorizadas pelas versões principais que as introduziram. Ao atualizar as versões do driver, resolva todas as alterações interruptivas entre sua versão atual e a versão de atualização planejada.

Alterações significativas na versão 4.x

  • As versões 4.x do driver não são compatíveis com Node.js v12.8 ou anterior. Se quiser utilizar esta versão do driver, você deve utilizar o Node.js v12.9 ou superior.

  • Cursor os tipos já não se estendem Readable diretamente.

  • Você não pode utilizar uma instância do ChangeStream como um iterador após utilizá-la como um EventEmitter. Você também não pode fazer o contrário – utilizar uma instância do EventEmitter como um iterador após utilizá-lo como um ChangeStream.

  • Os métodos a seguir não aceitam mais um parâmetro de chamada de resposta:

    • Collection.find()

    • Collection.aggregate()

    • Db.aggregate()

  • O valor-padrão da opção de conexão maxPoolSize agora é 100.

  • O driver não é mais compatível com a opção gssapiServiceName do Kerberos. Os usuários devem usar authMechanismProperties.SERVICE_NAME em vez dela.

  • O driver já não aceita tipos não boolean, como 0 ou 1, para opções boolean.

  • O tipo db.collection não aceita mais chamada de resposta.

  • O tipo Db não é mais um EventEmitter. Você pode ouvir qualquer evento diretamente da instância MongoClient.

  • O driver remove o suporte para o auxiliar Collection.group().

  • O driver não inclui mais a API GridStore obsoleta.

Para mais informações sobre estas alterações, consulte o registro de alterações na v4.0.

Alterações na compatibilidade da versão do servidor

Uma alteração de compatibilidade de versão do servidor é uma modificação no driver que descontinua o suporte para um conjunto de versões do Servidor MongoDB.

O driver interrompe o suporte para uma versão do Servidor MongoDB após atingir o fim da vida útil (EOL).

Para saber mais sobre o suporte MongoDB para produtos EOL, consulte a Política de Suporte Legado.

Versão 4.2: mudanças no suporte à versão do servidor

  • O driver v4.2 remove a compatibilidade com o MongoDB Server v3.4 e anterior. Para usar o driver v4.2, seu MongoDB Server deve ser v3.6 ou posterior. Para saber como atualizar seu MongoDB Server, consulte Notas da versão no manual do MongoDB Server.

← Compatibilidade

Nesta página