Partager via

Changement de la bibliothèque MessagePack dans @microsoft/signalr-protocol-msgpack

  • Article

Le package npm @microsoft/signalr-protocol-msgpack fait désormais référence à @msgpack/msgpack à la place de msgpack5. En outre, les options disponibles qui peuvent éventuellement être passées dans le MessagePackHubProtocol ont changé. Les propriétés MessagePackOptions.disableTimestampEncoding et MessagePackOptions.forceFloat64 ont été supprimées et de nouvelles options ont été ajoutées.

Pour plus d’informations, consultez https://github.com/dotnet/aspnetcore/issues/30471.

Version introduite

ASP.NET Core 6.0

Ancien comportement

Dans les versions précédentes, vous devez inclure trois références de script pour utiliser le protocole MessagePack Hub dans le navigateur :

<script src="~/lib/signalr/signalr.js"></script>
<script src="~/lib/msgpack5/msgpack5.js"></script>
<script src="~/lib/signalr/signalr-protocol-msgpack.js"></script>

Nouveau comportement

À compter de ASP.NET Core 6, vous n’avez besoin que de deux références de script pour utiliser le protocole MessagePack Hub dans le navigateur :

<script src="~/lib/signalr/signalr.js"></script>
<script src="~/lib/signalr/signalr-protocol-msgpack.js"></script>

Au lieu du package msgpack5, le package @msgpack/msgpack est téléchargé dans votre répertoire node_modules si vous souhaitez l’utiliser directement dans votre application.

Enfin, MessagePackOptions a de nouvelles propriétés supplémentaires et les propriétés disableTimestampEncoding et forceFloat64 sont supprimées.

Raison du changement

Ce changement a été apporté pour réduire la taille des ressources, simplifier l’utilisation du package et ajouter plus de personnalisation.

Si vous utilisiez msgpack5 précédemment dans votre application, vous devez ajouter une référence directe à la bibliothèque dans votre fichier package.json.

API affectées

Les API suivantes ont été supprimées :

  • MessagePackOptions.disableTimestampEncoding
  • MessagePackOptions.forceFloat64