Skip to content

Commit 0e3e506

Browse files
docs(NODE-4923): make note of drawbacks of the legacy driver (#13)
1 parent 5413962 commit 0e3e506

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

readme.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,13 @@ If callback usage is needed for any new APIs, we would suggest using `.then`/`.c
1818

1919
The main driver package `mongodb` will be dropping optional callback support in the next major version (v5) in favor of `async`/`await` syntax.
2020

21+
### Drawbacks
22+
23+
- The legacy driver wraps the native driver, which may lead to a slight performance penalty.
24+
- As discussed in the versioning section, it is recommended that `mongodb-legacy` replace the direct dependency on `mongodb`. This allows for
25+
the legacy driver to automatically pull in features and fixes from the native driver. However, this also removes control
26+
of which version of mongodb is installed. If users wish to control the version of mongodb directly, the lockfile will need edited manually.
27+
2128
### Example usage of equivalent callback and promise usage
2229

2330
```ts

0 commit comments

Comments
 (0)