Skip to content

Commit f6156a4

Browse files
Document Newtonsoft.Json 10.0.2 → 13.0.1 breaking change for Cosmos provider in EF Core 9.0 (#5303)
Fixes #4804 Co-authored-by: AndriySvyryd <6539701+AndriySvyryd@users.noreply.github.com>
1 parent 5c9376a commit f6156a4

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

entity-framework/core/what-is-new/ef-core-9.0/breaking-changes.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -348,6 +348,7 @@ Extensive work has gone into making the Azure Cosmos DB provider better in 9.0.
348348
| [Incorrectly translated queries are no longer translated](#cosmos-incorrect-translations) | Medium |
349349
| [`HasIndex` now throws instead of being ignored](#cosmos-hasindex-throws) | Low |
350350
| [`IncludeRootDiscriminatorInJsonId` was renamed to `HasRootDiscriminatorInJsonId` after 9.0.0-rc.2](#cosmos-IncludeRootDiscriminatorInJsonId-rename) | Low |
351+
| [The referenced Newtonsoft.Json version was updated from 10.0.2 to 13.0.1](#cosmos-newtonsoft-json-version) | Low |
351352

352353
### High-impact changes
353354

@@ -688,3 +689,23 @@ Another related API was renamed to start with `Has` instead of `Include`, and so
688689
##### Mitigations
689690

690691
If your code is using the `IncludeRootDiscriminatorInJsonId` API, simply change it to reference `HasRootDiscriminatorInJsonId` instead.
692+
693+
<a name="cosmos-newtonsoft-json-version"></a>
694+
695+
#### The referenced Newtonsoft.Json version was updated from 10.0.2 to 13.0.1
696+
697+
##### Old behavior
698+
699+
The Cosmos provider referenced Newtonsoft.Json version 10.0.2.
700+
701+
##### New behavior
702+
703+
Starting with EF Core 9.0, the Cosmos provider references Newtonsoft.Json version 13.0.1.
704+
705+
##### Why
706+
707+
The previously referenced version of Newtonsoft.Json has known vulnerabilities. The version was updated to avoid depending on a package version with known security issues.
708+
709+
##### Mitigations
710+
711+
The upgrade to Newtonsoft.Json 13.0.1 should not cause issues in most cases. If your application uses Newtonsoft.Json directly and relies on a specific older version, you can update your application to be compatible with Newtonsoft.Json 13.0.1 or later. See the [Newtonsoft.Json release notes](https://github.com/JamesNK/Newtonsoft.Json/releases) for details on changes between versions.

0 commit comments

Comments
 (0)